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FQPEWORD 

This  technical  report  covers  work  performed  under  Ai:  Force 
Contract  F33600-87-C-04 64 ,  DAPro  Project.  This  contract  is 
sponsored  by  the  Manufacturing  Technology  Directorate,  Air  Foice 
Systems  Comm.and,  Wr ight-Patterson  Air  Force  Base,  O'lio.  It  wa:: 
administered  under  the  technical  direction  of  Mr.  Bruce  A. 
Rasm^ussen,  Branch  Chief,  Integration  Technology  Division, 
Manufacturing  Technology  Directorate,  through  Mr.  David  L.  Judscr. , 
Project  Manager.  The  Prime  Contractor  was  Integration  Tech.nolcay 
Services,  Software  Programs  Division,  of  the  Control  Data 
Corporation,  Dayton,  Ohio,  under  the  direction  of  Mr.  W.  .A. 
Osborne.  The  DAPro  Project  Manager  for  Control  Data  Corpcrat  ion 
was  Mr.  Jimmy  P.  Maxwell. 

The  DAPro  project  was  created  to  continue  the  development,  test, 
and  demonstration  of  the  Integrated  Information  Support  S\'stem 
(IISS) .  The  IISS  technology  work  comprises  enhancements  to  IISS 
software  and  the  establishment  and  operation  of  IISS  test  bed 
hardware  and  communications  for  developers  and  users. 

The  following  list  names  the  Control  Data  Corporation 
subcontractors  and  their  contributing  activities: 

SCECONTRACTQR  ROLE 


Control  Data  Corporation  Responsible  for  the  overall  Common 

Data  Model  design  developm.ent  and 
implementation,  IISS  integration  ai.d 
test,  and  technology  transfer  of  I  ISC. 

D.  Appleton  Company  Responsible  for  providing  software 

information  services  for  the  Common 
Data  Model  and  IDEFIX  integration 
methodology . 

CMTEK  Responsible  for  defining  and  testii.u  a 

representative  i.'itegrated  system  base 
in  Artificial  Intelligence  techniques 
to  establish  fitness  fcr  use. 


-Dimpact  Corporation 


Responsible  for  Com.T.uni  .jat  icn 
deve lopment . 


1  1 


Accession  For 

NT IS  GRA4I 
DTIC  TAB 


Unannounced 
Justlf icatloa 


By - 

Dlotributi oiy 

Availability  Codes 


Dlst 


Avail  and/or 
Speolal 


□  □ 


structural  Dynamics 
Research  Corporation 


Responsible  for  User  Interface 
Virtual  Terminal  Int e r f ace , and 
Transaction  Manager  design, 
development,  implementation,  a 
support . 


Responsible  for  test  ted  opera 
and  support . 


Arizona  State  University 
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SECTION  1 
SCOPE 


1.1  Identification 


This  specification  establishes  the  'as  built'  design  of  the 
Software  Services  component  of  the  Network  Transaction  Manager 
Subsystem . 

1 . 2  Functional  Summary 

The  Network  Transaction  Manager  (NTM)  Subsystem  provides 
the  control  and  support  services  to  appication  processes  that 
are  grouped  together  logically  in  clusters  called  Application 
Process  Cluster  (APCs) .  These  application  processes  communicate 
ith  one  another  by  sending  messages  via  the  NTM.  The  NTM 
Olivers  these  messages  to  the  destination  application  processor 
while  also  providing  other  services  for  the  APs  such  as  message 
pairing,  AP  initiation,  and  message  queuing. 
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DOCUMENTS 


2.1  Reference  Documents 


The  follov;ing  pertinent  reference  materials  are  available 
at  the  ICAM  Program  Office. 


1.  Interim  Reports 

2.  Life  Cycle  Documents 

(a)  ITR620150002U  Project  Scope 

(b)  PMP620150000  Master  Plan  and  Schedule 

(c)  SAD620150000  State-of-the-Art  Review 

(d)  SRD620140000  System  Requirements  Document 

(e)  SDS620140000  System  Design  Speci f ications 

(f)  DS6201420000  Development  Specification  - 

Netv;ork  Transaction  Manager  Subsystem 


The  following  reference  materials  are  available  from 
Digital  Equipment  Corporation. 


(a) 

VAX/VMS  I/O  User's 
No. AA-M540B-TE 

Guide  (Volume  1) , 

Order 

(b) 

VAX/VMS  I/O  User's 
No. AA-M541B-TE 

Guide  (Volume  2 ) , 

Orde  r 

(c) 

VAX  COBOL  Language 
No. AA-H631C-TE 

Reference  Manual, 

Order 

(d) 

VAX-11  FORTRAN  Language  Reference  Manual, 
OrderNo.  AA-D034C-TE 

other  reference  materials  are  as  follows. 

(a)  International  Organization  for 
Standardization, Open  Systems  Interconnection, 
Information  Processing  Systems  -  Basic  Reference 
Model ,  TC  97/16  N  719 

(b)  International  Organization  for 
Standardization, Open  Systems  Interconnection, 
Draft,  Connection-Oriented  Transport  Service 
Definition  TC  97/16  N  860 

(c)  International  Organization  for  Standardization, 
Open  Systems  Interconnection,  Draft, 

Connect ion-Oriented  Transport  Protocol 
-SpociTication  Version  1.2,  TC  97/16  N  861 
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(d)  International  Organization  for  Standardization, 
Open  Systems  Interconnection,  Draft, 
Connection-Oriented  Session  Protocol  Definition 
TC  97/16  N  856 

(e)  National  Bureau  of  Standards,  Specification  of 
the  Transport  Protocol,  Volume  2 :  Basic 
Class  Protocol ,  Draft  Report ,  September  1981, 
Report  No.  ICST/HLNP-8 1-12 

(f)  National  Bureau  of  Standards,  Specification  of 
the  Transport  Protocol,  Volume  3:  Extended 
Class  Protocol ,  Draft  Report ,  September  1981, 
Report  No.  ICST/HLNP-81-13 

(g)  National  Bureau  of  Standards,  Specification  of 
the  Transport  Protocol ,  Volume  4 :  Network 
Interfaces ,  Draft  Report ,  September  1981,  Report 
No.  ICST/HLNP-81-14 


2.2  Terms  And  Abbreviations 


1.  Interhost  Communication  Primitives  (IHC ' s)  -  A  set  of 
routines  used  by  the  NTM  to  interface  to  the  operating 
system  or  to  other  operating  systems  which  have  an  NTM 
running.  They  are  always  system  dependent. 

2 .  Interprocess  Communication  Primitives  (IPC ' s)  -  A  set 
of  routines  used  to  communicate  between  two  processes 
on  the  same  computer.  They  are  always  system 
dependent . 
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SECTION  3 
REQUIREMENTS 


3 . 1  Structural  Descriptions 

The  NTM  Services  Modules  are  the  routines  that  are  bound 
v;ith  new  IISS  APs  to  provide  the  management  of  the  AP's 
communication  with  the  IISS. 


3 . 2  Functional  Flow  Description 

The  NTM  Services  can  be  grouped  according  to  their  basic 
function  in  the  following  way: 

The  NTM  Communication  Initiation  Routines: 

-  INICOM  (used  by  the  COMM  APs  for  initiation) 

-  INITAL  (used  for  initiation  by  all  IISS  APs  except 

COMM  and  the  UI) 

-  INITEX  (used  by  the  UI  AP  for  initiation) 

-  LOGON  (used  by  the  UI  to  send  user  logon 

information  to  the  NTM) 

The  NTM  Com.municat ion  Routines: 


CHGROL 

CHKMSG 

GDACK 

GDSEN 

ISEND 


NS  END 
QSEND 


RCV 

IGERR 

TSTMOD 


(used  by  the  UI  to  tell  the  NI'M  about  a 
user's  role  change) 

(used  as  a  check  to  determine  whether  a 
message  has  arrived  for  the  AP) 

(used  to  acknowledge  guaranteed  delivery 
messages) 

(used  to  send  guaranteed  delivery  messages) 
(used  to  send  a  message  that  will 
specifically  cause  the  initiation  of  a  new 
instance  of  an  IISS  AP) 

(used  to  send  message  to  other  IISS  APs) 
(used  by  Queue-Server  APs  to  send  messages 
back  to  the  AP  whose  message  was  just 
received) 

(used  to  receive  any  messages  that  may  havv 
been  sent  by  other  IISS  APs) 

(used  to  send  an  error  message  to  both  the 
user  of  this  AP  and  the  NTM  Monitor) 

(used  by  the  UI  to  signal  message  filtering 
needs) 


I.'TH  Status  Services 

-  GEIUSR  (used  to  get  user  informat  ioi'. ,  original 

source,  and  original  logical  channel) 

-  VvillHST  (used  to  determine  host  name  'vvhore  requLSt'.a 

AP  resides) 
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NTM  Termination  Services 

-  LOGOFF  (used  by  the  UI  to  inform  the  NTM  of  a  user 

logoff ) 

-  TRMNAT  (used  by  all  IISS  APs  to  terminate  their 

communication  connection  to  the  NTH) 

-  TRMNAX  (used  by  the  COMM  APs  to  terminate  their 

communicat ion  connection  to  the  NTM) 

3 . 3  Interfaces 


The  Network  Transaction  Manager  maintains  communications 
with  any  other  process  through  mailboxes.  The  mailboxes  are 
managed  by  the  Interprocess  Communication  Primitives  (IPC's). 

Communications  with  the  remote  computer  is  accomplished 
through  the  Communication  sub-system  process  v;hich  'will  be 
running  when  there  are  other  hosts  to  communicate  v;ith. 

3 . 4  Program  Interrupts 

Many  NTM  Services  are  interrupt  driven  v;ith  interrupts 
coming  either  from  the  IPC's  on  behalf  of  an  NTM  MPU.  VJaitir.j 
for  these  interrupts  is  performed  by  one  of  the  IPC  wait 
primitives.  If  a  response  must  be  received  v;ithin  a  particular- 
time  interval,  the  IPC's  associated  with  timing  are  used  along 
v/ith  one  of  the  wait's. 

3 . 5  Timing  and  Sequence  Description 

The  NTM  does  not  depend  on  any  particular  timing  sequences. 

3 . 6  Special  Control  Features 

The  Newtork  Transaction  Manager  Subsystem  does  not  includt-- 
any  special  control  features  as  defined  in  the  ICAM 
Documentation  Standards  manual. 

3 . 7  Storage  Allocation 

3.7.1  Data  Base  Definition 

3 . 7 . 1 . 1  File  Description 

All  file  handling  is  done  by  the  Message  Processing  '  siit;: 
and  not  by  the  NTM  Services  themselves. 

3 . 7 .  1 . 2  Table  Description 

There  are  no  tables  which  are  used  by  all  of  the  NTH 
Services.  Information  regarding  the  individual  APs  in  store  1  ,-ir:  i 
handled  by  the  Message  Processing  Units  and  not  by  the  NTM 
Services  themselves. 

3  .  7  .  1 .  3  Item  and  Constant  Description 
Described  in  the  DS . 
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3.7.2  CPC  Relationship 
3 . S  Object  Code  Creation 

The  generic  portion  ol  NTM  is  written  in  '^OBOL  and  'C'. 
This  has  been  successfully  compiled  on  a  VAX  11/730  under  \T-; 
an  IBM  3084  under  MVS,  and  a  Honeyv/ell  Level  6  under  Mod  400 

The  minimum,  computer  hardware  and  software  required  to 
create  and  run  NTM  in  the  IISS  environment  is  documented  in 
Installation  Guide  for  IISS  on  the  VAX  and  in  the  Irr-'t'  a  ;  '  .t.  i 
Guide  for  IISS  on  the  IBM. 

3 . 9  Adaption  Data 

The  command  procedures  to  the  create  IISS  AP  executable 
such  that  they  contain  the  NTM  Services  are  specific  to  e-ich 
ccr.puter  and  can  be  ^ound  under  Software  Configuration 
Managem.ont . 
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3.10  Detail  Design  Description 

The  upcoming  program  details  were  derived  from  all  module;-, 
that  were  selected  when  the  following  Documentation  Group  (m)  v;  i 
chosen : 

NTMSERV 


3.10.1  Main  Program  List 

The  following  is  a  list  of  all  "Main  Programs"  v;hich  are 
modules  that  are  not  called  by  any  other  module  being  documente 
here.  These  modules  are  either  program  entry  points  or,  if  the 
are  hooked  into  another  set  of  programs  via  subroutine  calls, 
they  are  the  points  the  external  programs  can  call  and  therefor 
enter  through.  To  differentiate  between  the  two  types  of  entry 
points,  look  at  the  individual  Module  Documentation  (section 
3.10.8)  and  look  at  Module  Type  for  each  of  the  Main  Program 
mciules  listed.  Note  whether  the  routine  is  a  Program, 
Subroutine,  or  Function.  If  it  is  a  Program,  it  is  truly  a  mai 
program  entry  point.  If  not,  then  it  is  merely  called  by  other 
programs  not  being  documented  here. 
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Module  Name 


Purpose 


ASCTIM 

CHGROL2 

CHKMSG2 

ERKAPI 

FILGEN 

GDACK2 

GDSEND2 

GETTIM 

GETUSR2 

INICOH2 

INITAL2 

INITEX2 

INITIL2 

INSTNC2 

ISEIID2 

LOGOFF2 

LOGON2 


CALLED  BY  MPU ' S  TO  GET  THE  SYSTEM  TIME  AS 
AN  ASCII  STRING. 

CHANGE  THE  ROLE  UNDER  WHICH  A  USER  LOGGED 
ON. 

TO  CHECK  FOR  MESSAGES  FROM  OTHER  APS  IN 
THE  IISS  . 

PURPOSE  NOT  KNOWN  -  ACTIVE  CODE. 


SENDS  GD  ACK  MESSAGE  TO  LOCAL  MPU. 

SEND  MESSAGES  THAT  REQUIRE  GUARANTEED 
DELIVERY  PROCESSING. 

GET  THE  SYSTEM  TIME  AS  A  BINARY  STRING. 

RETURNS  ORIGINAL  SOURCE,  LOGICAL  CHANNEL, 
AND  USER  NAME. 

INITIALIZE  AP'S  CONNECTION  TO  THE  IISS. 

INITIALIZE  AP'S  CONNECTION  TO  THE  TIV  MPU. 

INITIALIZE  UI  LIKE  AP'S  CONNECTION  TO  THE 
UIV  MPU. 

INITIALIZE  AN  AP's  CONNECTION  TO  AN  AP 
SELECTED  MPU. 

GET  THE  SYSGEN  INSTANCE  NUMBER. 

SEND  MESSAGE  THAT  WILL  CAUSE  THE  SPECIFIG 
INITIATION  OF  AN  AP. 

SENDS  LOGOFF  MESSAGE  TO  THE  MONITOR  AP. 
SENDS  LOGON  MESSAGE  TO  THE  MONITOR  AP. 
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NTM/SERV  Main  Program  List 


Module  Name 

Purpose 

MBXLG2 

PURPOSE  NOT  KNOWN  -  ACTIVE  CODE. 

MBXLOG 

PURPOSE  NOT  KNOWN  -  ACTIVE  CODE. 

QSEND2 

SEND  MESSAGES  TO  OTHER  APS  IN  THE  IISS 
FROM  QSERVER  AP ' S . 

RCLE 

REMOTE  COMPILE  AND  LINK  EXPERT  DRIVER 

SIGABT2 

SIGNAL  THE  MPU  TO  ABORT  A  CHILD  AP 

SIGERR 

CALL  SIGERR2 

SNDRCLE 

REMOTE  COMPILE  AND  LINK  EXPERT  CALLING 
SERVICE 

TRMNAX 

CALL  TRMNAX2 

TSTMOD 

CALL  COBOL  ROUTINE  TSTMOD2 

WHTHST 

CALL  WHTHST2 

3-6 


PS  6203423UO 
30  September  1990 


3.10.2  Module  List 

The  following  is  a  list  of  all  the  modules  being  documented 
here  along  with  their  purpose.  Each  module  has  a  unique  name, 
no  matter  what  language  it  was  written  in. 
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Module  Name 

ASCTIM 

CHGR0L2 

CHKMSG2 

ERRAPI 

FILGEN 

GDACK2 

GDSEND2 

GETTIM 

GETUSR2 

INIC0M2 

INITAL2 

INITEX2 

INITIL2 

INSTNC2 

ISEND2 

LOGOFF2 

L0G0N2 


PS  620342 
30  September  1 


NTM/SERV  Module  List 
Purpose 

CALLED  BY  MPU ' S  TO  GET  THE  SYSTEM  TIME  AS 
AN  ASCII  STRING. 

CHANGE  THE  ROLE  UNDER  WHICH  A  USER  LOGGED 
ON. 

TO  CHECK  FOR  MESSAGES  FROM  OTHER  APS  IN 
THE  IISS  . 

PURPOSE  NOT  KNOWN  -  ACTIVE  CODE. 


SENDS  GD  ACK  MESSAGE  TO  LOCAL  MPU. 

SEND  MESSAGES  THAT  REQUIRE  GUARANTEED 
DELIVERY  PROCESSING. 

GET  THE  SYSTEM  TIME  AS  A  BINARY  STRING. 

RETURNS  ORIGINAL  SOURCE,  LOGICAL  CHANNEL, 
AND  USER  NAME. 

INITIALIZE  AP'S  CONNECTION  TO  THE  IISS. 

INITIALIZE  AP'S  CONNECTION  TO  THE  TIV  MPU. 

INITIALIZE  UI  LIKE  AP'S  CONNECTION  TO  THE 
UIV  MPU. 

INITIALIZE  AN  AP's  CONNECTION  TO  AN  AP 
SELECTED  MPU. 

GET  THE  SYSGEN  INSTANCE  NUMBER. 

SEND  MESSAGE  THAT  WILL  CAUSE  THE  SPECIFIC 
INITIATION  OF  AN  AP. 

SENDS  LOGOFF  MESSAGE  TO  THE  MONITOR  AP. 
SENDS  LOGON  MESSAGE  TO  THE  MONITOR  AP. 
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VD  tJ 


NTM/SERV  Module  List 


PS  620 2 300 
30  September  1990 


Module  Name 


Purpose 


MBXLG2 

MBXLOG 

NSEND2 

POSTCOM 

PRECOM 

QSEND2 

RCLE 

RCLFILE 

RCV2 

SIGABT2 

SIGERR 

SIGERR2 

SNDRCLE 

TRMNAT 

TRMNAT2 

TRMNAX 

TRMNAX2 

TSTMOD 

TSTMOD2 


PURPOSE  NOT  KNOWN  -  ACTIVE  CODE. 
PURPOSE  NOT  KNOWN  -  ACTIVE  CODE. 
SEND  MESSAGE  TO  AN  AP  IN  THE  IISS. 


SEND  MESSAGES  TO  OTHER  APS  IN  THE  IISS 
FROM  QSERVER  AP ' S . 

REMOTE  COMPILE  AND  LINK  EXPERT  DRIVER 

RECEIVE  MESSAGES  FROM  OTHER  AP ' S  IN  THE 
IISS  . 

SIGNAL  THE  MPU  TO  ABORT  A  CHILD  AP 
CALL  SIGERR2 

SENDS  AN  ERROR  MESSAGE  TO  MONITOR  AND  TO 
ORIGINAL  SOURCE. 

REMOTE  COMPILE  AND  LINK  EXPERT  CALLING 
SERVICE 

CALL  TRMNAT2 

TERMINATE  AN  AP ' S  CONNECTION  TO  THE  TISS. 
CALL  TRMNAX2 

TERMINATE  COMM ' S  CONNECTION  TO  THE  IISS. 
CALL  COBOL  ROUTINE  TSTMOD2 
SET/RESET  THE  TEST-MODE-FLAG. 
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NTM/SERV  Module  List 


Module 

WHTHST 

V;HTHST2 


PS  620342300 
30  September  lOOu 


Name  Purpose 


CALL  WHTHST2 

RETURNS  THE  NAME  OF  THE  HOST  ON  WHICH  AN 
AP  RESIDES. 
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PS  620342300 
30  September  1990 


3.10.3  External  Routines  List 

The  following  is  a  list  of  all  routines  or  functions  not 
documented  here  that  are  called  by  modules  that  are  documenteJ 
here.  The  first  caller,  in  alphabetical  order,  is  listed  as 
well.  The  specification  in  which  any  module  is  documented  m; 
be  found  in  the  Module  Documentation  Index  (Document  Number 
620100001).  See  section  3.10.6  for  a  list  of  the  miOdules  that 
call  each  of  these  external  routines. 


3-1 1 


n  o 


NTM/SERV 
Module  Name 


APACCT 

CNLTIM 

CRTMBX 

DELMBX 

ENDRUN 

ERRPRO 

GETMSG 

GETNAM 

INITAL 

ISEND 

LOCKEF 

NSEND 

RCV 

RCVMSG 

RELEVB 

SETTIM 

SNDMSG 

SYS$ASCTIM 

SYS$CREPRC 

SYS$GETJPI 

SYS$GETTIM 

WAITOl 

WAIT02 


PS  620342  30(j 
30  September  1091* 


External  Routines  List 

First  User 


WHTHST 

ISEND2 

INICOM2 

TRMNAT2 

TRMNAX2 

SIGERR2 

RCV2 

INITEX2 

RCLE 

SNDRCLE 

INITAL2 

FILGEN 

RCLE 

RCV2 

INITIL2 

INITEX2 

TRMNAT2 

ASCTIM 

RCLE 

RCLE 

GETTIM 

INITIL2 

QSEND2 
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3.10.4  Include  File  List 


The  following  is  a  list  of  all  include  files  called  in  by 
modules  being  documented  here.  Each  include  file  has  a  unique 
name  regardless  of  the  language  being  used.  The  purpose  of  each 
include  file  is  listed  as  well.  A  more  complete  description  of 
each  include  file  is  given  in  section  3.10.9.  The  purpose  listed 
is  the  one  that  is  in  the  source  code  of  the  include  file. 


A  purpose  of  "****  PURPOSE  NOT  FOUND  BY  STRIPPER  ****■' 
indicates  that  a  purpose  statement  was  not  written  into  the 
include  file  itself.  The  most  common  reason  for  this  is  tl  ’.t 
the  include  file  comes  from  system  libraries  that  v.ere  not 
developed  by  the  project,  such  as  'C  libraries  that  are 
provided  with  the  'C  compiler. 

See  section  3.10.6  for  a  set  of  lists  v;hich  shov.-  all  the 
modules  which  call  in  each  of  these  include  files. 
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NTM/SERV  Include  File  List 


File  Name 


Purpose 


ADMSGH 

ALMSGH 

APCNMl 

APCNM2 

APIFVB 

APIINI 

APILCL 

APINME 

BUFAPI 

COMAPC 

FRRPRO 

INICMD 

MSGSTR 

RFTSTR 

SRVCD2 

SRVCDS 

SRVRET 

TSTMDE 


THE  APIS  COMMON  LOCAL  DATA  FOR  ERROR-RETURNS. 
SPACES  OR  0. 

APIS  GLOBAL  NAME  DATA. 

SERVICE  CODES  FOR  THE  NTM  SERVICE  ROUTINES. 
****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

FOR  INITIATION  PURPOSES 
THE  APIS  COMMON  LOCAL  DATA. 

****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

PROCESS  ERROR  INCLUDE  FILE 

PROCESS  ERROR  INCLUDE  FILE 

PROCESS  ERROR  INCLUDE  FILE 

PURPOSE 

THE  APIS  COMMON  LOCAL  DATA  FOR  ERROR-RETURNS. 
THAT  CALL  NSEND  AND  RCV 

SERVICE  CODES  FOR  THE  NTM  SERVICE  ROUTINES. 

AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 
SPACES  OR  0. 
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3.10.5  Where  Include  File  Used  List 

The  following  lists  each  include  file  from  3.10.4  and  all 
the  modules  documented  in  this  specification  which  include  them. 
The  purpose  of  each  module  is  listed  as  well. 
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NTM/SERV  Wheie-include-f ile-used  List 


Include 

File 

Module 

Name 

Module 

Purpose 

ADMSGH 

TRMNAT2 

TRMNAX2 

TERMINATE  AN  AP ' S  CONNECTION  TO  THE  IISS. 
TERMINATE  COMM ' S  CONNECTION  TO  THE  IISS. 

ALMSGH 

INICOM2 

INITAL2 

INITEX2 

INITIL2 

INITIALIZE  AP 
INITIALIZE  AP 
INITIALIZE  UI 
UIV  MPU. 
INITIALIZE  AN 
SELECTED  MPU. 

'S  CONNECTION  TO  THE  IISS. 

'S  CONNECTION  TO  THE  TIV  MPU. 
LIKE  AP'S  CONNECTION  TO  THE 

AP's  CONNECTION  TO  AN  AP 

APCNMl 

INITEX2 

INITIALIZE  UI 
UIV  MPU, 

LIKE  AP'S  CONNECTION  TO  THE 

APCNM2 

INITAL2 

INITIL2 

INITIALIZE  AP 
INITIALIZE  AN 
SELECTED  MPU. 

'S  CONNECTION  TO  THE  TIV  MPU. 
AP's  CONNECTION  TO  AN  AP 

APIEVB 

CHGROL2 

CHKMSG2 

GDACK2 

CHANGE  THE  ROLE  UNDER  WHICH  A  USER  LOGGED 
ON. 

TO  CHECK  FOR  MESSAGES  FROM  OTHER  APS  IN 

THE  IISS  . 

SENDS  GD  ACK  MESSAGE  TO  LOCAL  MPU. 
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NTM/SERV  Where-include-f ile-used  List 

Include  Module  Module 

File  Name  Purpose 


GDSEND2  SEND  MESSAGES  THAT  REQUIRE  GUARANTEED 
DELIVERY  PROCESSING. 

GETUSR2  RETURNS  ORIGINAL  SOURCE,  LOGICAL  CHANNEL, 
AND  USER  NAME. 

INITAL2  INITIALIZE  AP ' S  CONNECTION  TO  THE  TIV  MPU 

INITEX2  INITIALIZE  UILIKE  AP'S  CONNECTION  10  Ird 
UIV  MPU. 

INITIL2  INITIALIZE  AN  AP ’ s  CONNECTION  TO  AN  AP 
SELECTED  MPU. 

ISEND2  SEND  MESSAGE  THAT  WILL  CAUSE  THE  SPECIFIC 
INITIATION  OF  AN  AP. 

LOGOFF2  SENDS  LOGOFF  MESSAGE  TO  THE  MONITOR  AP. 

LOGON2  SENDS  LOGON  MESSAGE  TO  THE  MONITOR  AP. 

NSEND2  SEND  MESSAGE  TO  AN  AP  IN  THE  IISS. 

QSEND2  SEND  MESSAGES  TO  OTHER  APS  IN  THE  IISS 
FROM  QSERVER  AP'S. 

RCLE  REMOTE  COMPILE  AND  LINK  EXPERT  DRIVER 

RCV2  RECEIVE  MESSAGES  FROM  OTHER  AP'S  IN  THE 

IISS  , 

SIGABT2  SIGNAL  THE  MPU  TO  ABORT  A  CHILD  AP 

SIGERR  CALL  SIGERR2 

SIGERR2  SENDS  AN  ERROR  MESSAGE  TO  MONITOR  AND  TO 
ORIGINAL  SOURCE. 

TRMNAT  CALL  TRMNAT2 

TRMNAT2  TERMINATE  AN  AP'S  CONNECTION  TO  THE  IISS. 

TSTMOD  CALL  COBOL  ROUTINE  TSTMOD2 

WHTHST  CALL  WHTHST2 

WHTHST2  RETURNS  THE  NAME  OF  THE  HOST  ON  WHICH  AN 
AP  RESIDES. 


API INI 

INITAL2  INITIALIZE  AP'S  CONNECTION  TO  THE  TIV  MPU. 
INITEX2  INITIALIZE  UI  LIKE  AP'S  CONNECTION  TO  THE 
UIV  MPU. 

INITIL2  INITIALIZE  AN  AP's  CONNECTION  TO  AN  AP 
SELECTED  MPU. 


3-17 


PS  620342 
30  September  1 


NTM/SERV  Where-include-f ile-used  List 

Include  Module  Module 

File  Name  Purpose 


APILCL 

CHKMSG2  TO  CHECK  FOR  MESSAGES  FROM  OTHER  APS  IN 
THE  IISS  . 

GDACK2  SENDS  CD  ACK  MESSAGE  TO  LOCAL  MPU . 

GDSEND2  SEND  MESSAGES  THAT  REQUIRE  GUARANTEED 
DELIVERY  PROCESSING. 

INITAL2  INITIALIZE  AP'S  CONNECTION  TO  THE  TIV  MPU. 

INITEX2  INITIALIZE  UI  LIKE  AP'S  CONNECTION  TO  THE 
UIV  MPU. 

INITIL2  INITIALIZE  AN  AP ' s  CONNECTION  TO  AN  AP 
SELECTED  MPU. 

ISEND2  SEND  MESSAGE  THAT  WILL  CAUSE  THE  SPECIFIC 
INITIATION  OF  AN  AP. 

NSEND2  SEND  MESSAGE  TO  AN  AP  IN  THE  IISS. 

QSEND2  SEND  MESSAGES  TO  OTHER  APS  IN  THE  IISS 
FROM  QSERVER  AP'S. 

RCLE  REMOTE  COMPILE  AND  LINK  EXPERT  DRIVER 

RCV2  RECEIVE  MESSAGES  FROM  OTHER  AP'S  IN  THE 

IISS  . 

SIGABT2  SIGNAL  THE  MPU  TO  ABORT  A  CHILD  AP 

SIGERR2  SENDS  AN  ERROR  MESSAGE  TO  MONITOR  AND  TO 

ORIGINAL  SOURCE. 

TRMNAT2  TERMINATE  AN  AP'S  CONNECTION  TO  THE  IISS. 

TRMNAX2  TERMINATE  COMM ' S  CONNECTION  TO  THE  IISS. 


APINME 

CHGROL2  CHANGE  THE  ROLE  UNDER  WHICH  A  USER  LOGGED 
ON. 

CHKMSG2  TO  CHECK  FOR  MESSAGES  FROM  OTHER  APS  IN 
THE  IISS  . 

GDACK2  SENDS  GD  ACK  MESSAGE  TO  LOCAL  MPU. 

GDSEND2  SEND  MESSAGES  THAT  REQUIRE  GUARANTEED 
DELIVERY  PROCESSING. 


PS  620342300 
30  September  1990 


NTM/SERV  Where-include-f ile-used  List 

Include  Module  Module 

File  Name  Purpose 


GETUSR2  RETURNS  ORIGINAL  SOURCE,  LOGICAL  CHANNEL, 
AND  USER  NAME. 

INITAL2  INITIALIZE  AP'S  CONNECTION  TO  THE  TIV  MPU. 

INITEX2  INITIALIZE  UI  LIKE  AP'S  CONNECTION  TO  THE 
UIV  MPU. 

INITIL2  INITIALIZE  AN  AP ' s  CONNECTION  TO  AN  AP 
SELECTED  MPU. 

ISEND2  SEND  MESSAGE  THAT  WILL  CAUSE  THE  SPECIFIC 
INITIATION  OF  AN  AP. 

LOGOFF2  SENDS  LOGOFF  MESSAGE  TO  THE  MONITOR  AP. 

LOGON2  SENDS  LOGON  MESSAGE  TO  THE  MONITOR  AP. 

NSEND2  SEND  MESSAGE  TO  AN  AP  IN  THE  IISS. 

QSEND2  SEND  MESSAGES  TO  OTHER  APS  IN  THE  IISS 
FROM  QSERVER  AP'S. 

RCV2  RECEIVE  MESSAGES  FROM  OTHER  AP'S  IN  THE 

IISS  . 

SIGABT2  SIGNAL  THE  MPU  TO  ABORT  A  CHILD  AP 

SIGERR  CALL  SIGERR2 

SIGERR2  SENDS  AN  ERROR  MESSAGE  TO  MONITOR  AND  TO 
ORIGINAL  SOURCE. 

TRMNAT  CALL  TRMNAT2 

TRMNAT2  TERMINATE  AN  AP'S  CONNECTION  TO  THE  IISS. 

WHTHST  CALL  WHTHST2 

WHTHST2  RETURNS  THE  NAME  OF  THE  HOST  ON  WHICH  AN 

AP  RESIDES. 


BUFAPI 

CHGROL2  CHANGE  THE  ROLE  UNDER  WHICH  A  USER  LOGGED 
ON. 

CHKMSG2  TO  CHECK  FOR  MESSAGES  FROM  OTHER  APS  IN 
THE  IISS  . 

GDACK2  SENDS  GD  ACK  MESSAGE  TO  LOCAL  MPU. 

GDSEND2  SEND  MESSAGES  THAT  REQUIRE  GUARANTEED 
DELIVERY  PROCESSING. 

GETUSR2  RETURNS  ORIGINAL  SOURCE,  LOGICAL  CHANNEL, 
AND  USER  NAME. 

INITAL2  INITIALIZE  AP'S  CONNECTION  TO  THE  TIV  MPU. 
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NTM/SERV  Where-include-f ile-used  List 

Include  Module  Module 

File  Name  Purpose 


INITEX2  INITIALIZE  UI  LIKE  AP ' S  CONNECTION  TO  THE 
UIV  MPU. 

INITIL2  INITIALIZE  AN  AP ' s  CONNECTION  TO  AN  AP 
SELECTED  MPU. 

ISEND2  SEND  MESSAGE  THAT  WILL  CAUSE  THE  SPECIFIC 
INITIATION  OF  AN  AP. 

LOGOFF2  SENDS  LOGOFF  MESSAGE  TO  THE  MONITOR  AP. 

LOGON2  SENDS  LOGON  MESSAGE  TO  THE  MONITOR  AP. 

NSEND2  SEND  MESSAGE  TO  AN  AP  IN  THE  IISS. 

QSEND2  SEND  MESSAGES  TO  OTHER  APS  IN  THE  IISS 
FROM  QSERVER  AP'S. 

RCV2  RECEIVE  MESSAGES  FROM  OTHER  AP'S  IN  THE 

IISS  . 

SIGABT2  SIGNAL  THE  MPU  TO  ABORT  A  CHILD  AP 

SIGERR  CALL  SIGERR2 

SIGERR2  SENDS  AN  ERROR  MESSAGE  TO  MONITOR  AND  TO 
ORIGINAL  SOURCE. 

WHTHST  CALL  WHTHST2 

WHTHST2  RETURNS  THE  NAME  OF  THE  HOST  ON  WHICH  AN 

AP  RESIDES. 


COMAPC 

TRiMNAX2  TERMINATE  COMM '  S  CONNECTION  TO  THE  IISS. 


ERRPRO 

CHGROL2  CHANGE  THE  ROLE  UNDER  WHICH  A  USER  LOGGED 
ON. 

CHKMSG2  TO  CHECK  FOR  MESSAGES  FROM  OTHER  APS  IN 
THE  IISS  . 

FILGEN 

GDACK2  SENDS  GD  ACK  MESSAGE  TO  LOCAL  MPU. 

GDSEND2  SEND  MESSAGES  THAT  REQUIRE  GUARANTEED 
DELIVERY  PROCESSING. 
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NTM/SERV  Where-include-f ile-used  List 


Include 

File 


Module 

Name 


Module 

Purpose 


GETUSR2 

INICOM2 

INITAL2 

INITEX2 

INITIL2 

ISEND2 

LOGOPF2 

LOGON2 

NSEND2 

QSEND2 

RCLE 

RCV2 

SIGABT2 

SIGERR2 

TRMNAT2 

TRMNAX2 

WHTHST2 


RETURNS  ORIGINAL  SOURCE,  LOGICAL  CHANNEL, 
AND  USER  NAME. 

INITIALIZE  AP'S  CONNECTION  TO  THE  IISS. 
INITIALIZE  AP'S  CONNECTION  TO  THE  TIV  MPU . 
INITIALIZE  UI  LIKE  AP'S  CONNECTION  TO  THE 
UIV  MPU. 

INITIALIZE  AN  AP's  CONNECTION  TO  AN  AP 
SELECTED  MPU. 

SEND  MESSAGE  THAT  WILL  CAUSE  THE  SPECIFIC 
INITIATION  OF  AN  AP. 

SENDS  LOGOFF  MESSAGE  TO  THE  MONITOR  AP. 
SENDS  LOGON  MESSAGE  TO  THE  MONITOR  AP. 

SEND  MESSAGE  TO  AN  AP  IN  THE  IISS. 

SEND  MESSAGES  TO  OTHER  APS  IN  THE  IISS 
FROM  QSERVER  AP'S. 

REMOTE  COMPILE  AND  LINK  EXPERT  DRIVER 
RECEIVE  MESSAGES  FROM  OTHER  AP'S  IN  THE 
IISS  . 

SIGNAL  THE  MPU  TO  ABORT  A  CHILD  AP 
SENDS  AN  ERROR  MESSAGE  TO  MONITOR  AND  TO 
ORIGINAL  SOURCE. 

TERMINATE  AN  AP'S  CONNECTION  TO  THE  IISS. 
TERMINATE  COMM'S  CONNECTION  TO  THE  IISS. 
RETURNS  THE  NAME  OF  THE  HOST  ON  WHICH  AN 
AP  RESIDES. 


INI CM D 

INICOM2  INITIALIZE  AP'S  CONNECTION  TO  THE  IISS. 


MSGSTR 

CHKMSG2  TO  CHECK  FOR  MESSAGES  FROM  OTHER  ATS  IN 
THE  IISS  . 

GDSEND2  SEND  MESSAGES  THAT  REQUIRE  GUARANI  FED 
DELIVERY  PROCESSING. 
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NTM/SERV  Where-include-f ile-used  List 


Include 

Module 

Module 

File 

Name 

Purpose 

ISEND2 

SEND  MESSAGE  THAT  WILL  CAUSE  THE  SPECIFIC 
INITIATION  OF  AN  AP. 

NSEND2 

SEND  MESSAGE  TO  AN  AP  IN  THE  IISS. 

QSEND2 

SEND  MESSAGES  TO  OTHER  APS  IN  THE  IISS 
FROM  QSERVER  AP'S. 

RCV2 

RECEIVE  MESSAGES  FROM  OTHER  AP'S  IN  THE 
IISS  . 

RETSTR 

CHGROL2  CHANGE  THE  ROLE  UNDER  WHICH  A  USER  LOGGED 
ON. 

CHKMSG2  TO  CHECK  FOR  MESSAGES  FROM  OTHER  APS  IN 
THE  IISS  . 

GDACK2  SENDS  GD  ACK  MESSAGE  TO  LOCAL  MPU , 

GDSEND2  SEND  MESSAGES  THAT  REQUIRE  GUARANTEED 
DELIVERY  PROCESSING. 

GETUSR2  RETURNS  ORIGINAL  SOURCE,  LOGICAL  CHANNEL, 
AND  USER  NAME. 

INITAL2  INITIALIZE  AP'S  CONNECTION  TO  THE  TIV  MPU. 

INITEX2  INITIALIZE  UI  LIKE  AP'S  CONNECTION  TO  THE 
UIV  MPU. 

INITIL2  INITIALIZE  AN  AP's  CONNECTION  TO  AN  AP 
SELECTED  MPU. 

ISEND2  SEND  MESSAGE  THAT  WILL  CAUSE  THE  SPECIFIC 
INITIATION  OF  AN  AP. 

LOGOFF2  SENDS  LOGOFF  MESSAGE  TO  THE  MONITOR  AP. 

LOGON2  SENDS  LOGON  MESSAGE  TO  THE  MONITOR  AP. 

NSEND2  SEND  MESSAGE  TO  AN  AP  IN  THE  IISS. 

QSEND2  SEND  MESSAGES  TO  OTHER  APS  IN  THE  IISS 
FROM  QSERVER  AP'S. 

RCLE  REMOTE  COMPILE  AND  LINK  EXPERT  DRIVER 

RCV2  RECEIVE  MESSAGES  FROM  OTHER  AP'S  IN  THE 

IISS  . 

SIGABT2  SIGNAL  THE  MPU  TO  ABORT  A  CHILD  AP 

SIGERR2  SENDS  AN  ERROR  MESSAGE  TO  MONITOR  AND  TO 

ORIGINAL  SOURCE. 

TRMNAT2  TERMINATE  AN  AP'S  CONNECTION  TO  THE  IISS. 
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NTM/SERV  Where-include-f ile-used  List 

Include  Module  Module 

File  Name  Purpose 


TRMNAX2  TERMINATE  COMM'S  CONNECTION  TO  THE  IISS. 
WHTHST2  RETURNS  THE  NAME  OF  THE  HOST  ON  WHICH  AN 
AP  RESIDES. 


SRVCD2 

CHGROL2  CHANGE  THE  ROLE  UNDER  V^JHICH  A  USER  LOGGED 
ON. 

GDACK2  SENDS  GD  ACK  MESSAGE  TO  LOCAL  MPU . 

GETUSR2  RETURNS  ORIGINAL  SOURCE,  LOGICAL  CHANNEL, 
AND  USER  NAME. 

LOGOFF2  SENDS  LOGOFF  MESSAGE  TO  THE  MONITOR  AP. 
LOGON2  SENDS  LOGON  MESSAGE  TO  THE  MONITOR  AP. 
SIGABT2  SIGNAL  THE  MPU  TO  ABORT  A  CHILD  AP 

SIGERR2  SENDS  AN  ERROR  MESSAGE  TO  MONITOR  AND  TO 

ORIGINAL  SOURCE. 

TSTMOD2  SET/RESET  THE  TEST-MODE-FLAG. 

WHTHST2  RETURNS  THE  NAME  OF  THE  HOST  ON  WHICH  AN 
AP  RESIDES. 


SRVCDS 

CHKMSG2  TO  CHECK  FOR  MESSAGES  FROM  OTHER  APS  IN 
THE  IISS  . 

GDSEND2  SEND  MESSAGES  THAT  REQUIRE  GUARANTEED 
DELIVERY  PROCESSING. 

INITAL2  INITIALIZE  AP'S  CONNECTION  TO  THE  TIV  MPU. 
INITEX2  INITIALIZE  UI  LIKE  AP'S  CONNECTION  TO  THE 
UIV  MPU. 

INITIL2  INITIALIZE  AN  AP’s  CONNECTION  TO  AN  AP 
SELECTED  MPU. 

ISEND2  SEND  MESSAGE  THAT  WILL  CAUSE  THE  SPECIFi: 
INITIATION  OF  AN  AP. 

NSEND2  SEND  MESSAGE  TO  AN  AP  IN  THE  IISS. 

QSEND2  SEND  MESSAGES  TO  OTHER  APS  IN  THE  IISS 
FROM  QSERVER  AP'S. 
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NTM/SERV  Where-include-f ile-used  List 

Include  Module  Module 

File  Name  Purpose 


RCV2  RECEIVE  MESSAGES  FROM  OTHER  AP ' S  IN  THE 

IISS  . 

TRMNAT2  TERMINATE  AN  AP ' S  CONNECTION  TO  THE  IISS. 
TRMNAX2  TERMINATE  COMM ' S  CONNECTION  TO  THE  IISS. 


SRYRET 

CHGROL2  CHANGE  THE  ROLE  UNDER  WHICH  A  USER  LOGGED 
ON. 

FILGEN 

GDACK2  SENDS  GD  ACK  MESSAGE  TO  LOCAL  MPU . 

GETUSR2  RETURNS  ORIGINAL  SOURCE,  LOGICAL  CHANNEL, 
AND  USER  NAME. 

LOGOFF2  SENDS  LOGOFF  MESSAGE  TO  THE  MONITOR  AP. 
LOGON2  SENDS  LOGON  MESSAGE  TO  THE  MONITOR  AP. 
RCLE  REMOTE  COMPILE  AND  LINK  EXPERT  DRIVER 

SIGABT2  SIGNAL  THE  MPU  TO  ABORT  A  CHILD  AP 

SIGERR2  SENDS  AN  ERROR  MESSAGE  TO  MONITOR  AND  TO 
ORIGINAL  SOURCE. 

SNDRCLE  REMOTE  COMPILE  AND  LINK  EXPERT  CALLING 
SERVICE 

WHTHST2  RETURNS  THE  NAME  OF  THE  HOST  ON  WHICH  AN 
AP  RESIDES. 


TSTMDE 

CHKMSG2  TO  CHECK  FOR  MESSAGES  FROM  OTHER  APS  IN 
THE  IISS  . 

GETUSR2  RETURNS  ORIGINAL  SOURCE,  LOGICAL  CHANNEL, 
AND  USER  NAME. 

INITAL2  INITIALIZE  AP'S  CONNECTION  TO  THE  TIV  MPU. 
INITEX2  INITIALIZE  UI  LIKE  AP'S  CONNECTION  TO  THE 
UIV  MPU. 

INITIL2  INITIALIZE  AN  AP's  CONNECTION  TO  AN  AP 
SELECTED  MPU. 

SENDS  LOGON  MESSAGE  TO  THE  MONITOR  AP. 


LOGON2 


PS  62034230U 
30  September  1990 


NTM/SERV  Where-include-f ile-used  List 

Include  Module  Module 

File  Name  Purpose 


RCV2  RECEIVE  MESSAGES  FROM  OTHER  AP ' S  IN  THE 

IISS  . 

SIGABT2  SIGNAL  THE  MPU  TO  ABORT  A  CHILD  AP 
TSTMOD2  SET/RESET  THE  TEST-MODE-FLAG. 

WHTHST2  RETURNS  THE  NAME  OF  THE  HOST  ON  WHICH  AN 
AP  RESIDES. 


3.10.6  Where  External  Routine  Used  List 


PS  G  2  0  3  2 
30  September  1 


The  following  lists  each  external  function  or  routine 
listed  in  3.10.3  and  all  the  documented  modules  which  call  it. 
The  purpose  of  each  module  is  listed  as  well. 
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NTM/SERV  Where-external -rout ine-used  List 

System  Module  Module 

Module  Name  Purpose 


APACCT 

SIGERR  CALL  SIGERR2 

TRMNAT  CALL  TRMNAT2 

TRMNAX  CALL  TRMNAX2 

TSTMOD  CALL  COBOL  ROUTINE  TSTMOD2 

WHTHST  CALL  WHTHST2 


CNLTIM 

GDSEND2  SEND  MESSAGES  THAT  REQUIRE  GUARANTEED 
DELIVERY  PROCESSING. 

ISEND2  SEND  MESSAGE  THAT  WILL  CAUSE  THE  SPECIFIC 
INITIATION  OF  AN  AP. 

NSEND2  SEND  MESSAGE  TO  AN  AP  IN  THE  IISS. 

QSEND2  SEND  MESSAGES  TO  OTHER  APS  IN  THE  IISS 
FROM  QSERVER  AP ' S . 


CRTMBX 

INICOM2  INITIALIZE  AP'S  CONNECTION  TO  THE  IISS. 

INITAL2  INITIALIZE  AP'S  CONNECTION  TO  THE  TIV  MPN. 

INITEX2  INITIALIZE  UI  LIKE  AP'S  CONNECTION  TO  THE 
UIV  MPU. 

INITIL2  INITIALIZE  AN  AP'S  CONNECTION  TO  AN  AP 
SELECTED  MPU. 


DEIJIBX 

INITAL2  INITIALIZE  AP'S  CONNECTION  TO  IHE  TIV  MPU. 
INITEX2  INITIALIZE  UI  LIKE  AP'S  CONr.'hCriON  TC  TH; 
UIV  MPU. 

INITIL2  INITIALIZE  AN  AP's  CONNECTION  TO  AN  AP 
SELECTED  MPU. 

TRMNAT2  TERMINATE  AN  AP'S  CONNECTION  TO  THE  USE. 
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NTM/SERV  Where-external-routine-used  List 

System  Module  Module 

Module  Name  Purpose 


ENDRUN 

TRMNAT2  TERMINATE  AN  AP'S  CONNECTION  TO  THE  IISS. 
TRMNAX2  TERMINATE  COMM ' S  CONNECTION  TO  THE  IISS. 


ERRPRO 

CHGROL2 

CHKMSG2 

FILGEN 

GDACK2 

GDSEND2 

GETUSR2 

INIC0M2 

INITAL2 

INITEX2 

INITIL2 

ISEND2 

L0G0FF2 

LOGON2 

NSEND2 

QSEND2 

RCLE 

RCV2 

SIGABT2 

SIGERR2 

TRMNAT2 

TRMNAX2 

WHTHST2 


CHANGE  THE  ROLE  UNDER  WHICH  A  USER  LOGGED 
ON. 

TO  CHECK  FOR  MESSAGES  FROM  OTHER  APS  IN 
THE  IISS  . 

SENDS  GD  ACK  MESSAGE  TO  LOCAL  MPU . 

SEND  MESSAGES  THAT  REQUIRE  GUARANTEED 
DELIVERY  PROCESSING. 

RETURNS  ORIGINAL  SOURCE,  LOGICAL  CHANNEL, 
AND  USER  NAME. 

INITIALIZE  AP'S  CONNECTION  TO  THE  IISS. 
INITIALIZE  AP'S  CONNECTION  TO  THE  TIV  MPU. 
INITIALIZE  UI  LIKE  AP'S  CONNECTION  TO  THE 
UIV  MPU. 

INITIALIZE  AN  AP'S  CONNECTION  TO  AN  AP 
SELECTED  MPU. 

SEND  MESSAGE  THAT  WILL  CAUSE  THE  SPECIFIC 
INITIATION  OF  AN  AP. 

SENDS  LOGOFF  MESSAGE  TO  THE  MONITOR  AP. 
SENDS  LOGON  MESSAGE  TO  THE  MONITOR  AP . 

SEND  MESSAGE  TO  AN  AP  IN  THE  IISS. 

SEND  MESSAGES  TO  OTHER  APS  IN  THE  IISS 
FROM  QSERVER  AP'S. 

REMOTE  COMPILE  AND  LINK  EXPERT  DRIVER 
RECEIVE  MESSAGES  FROM  OTHER  AP'S  IN  THE 
IISS  . 

SIGNAL  THE  MPU  TO  ABORT  A  CHILD  AP 
SENDS  AN  ERROR  MESSAGE  TO  MONITOR  AND  TO 
ORIGINAL  SOURCE. 

TERMINATE  AN  AP'S  CONNECTION  TO  THE  IISS. 
TERMINATE  COMM ' S  CONNECTION  TO  THE  IISS. 
RETURNS  THE  NAME  OF  THE  HOST  ON  WHICH  AN 
AP  RESIDES. 
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NTM/SERV  Where-external-routine-used  List 

System  Module  Module 

Module  Name  Purpose 


GETMSG 

CHKMSG2  TO  CHECK  FOR  MESSAGES  FROM  OTHER  APS  IN 
THE  IISS  . 

GDSEND2  SEND  MESSAGES  THAT  REQUIRE  GUARANTEED 
DELIVERY  PROCESSING. 

INICOM2  INITIALIZE  AP ' S  CONNECTION  TO  THE  IISS. 

INITAL2  INITIALIZE  AP ' S  CONNECTION  TO  THE  TIV  MPU . 

INITEX2  INITIALIZE  UI  LIKE  AP ' S  CONNECTION  TO  THE 
UIV  MPU. 

IHITIL2  INITIALIZE  AN  AP's  CONNECTION  TO  AN  AP 
SELECTED  MPU. 

ISEND2  SEND  MESSAGE  THAT  WILL  CAUSE  THE  SPECIFTT 
INITIATION  OF  AN  AP . 

NSEND2  SEND  MESSAGE  TO  AN  AP  IN  THE  IISS. 

QSEND2  SEND  MESSAGES  TO  OTHER  APS  IN  THE  IISS 
FROM  QSERVER  AP'S. 

RCV2  RECEIVE  MESSAGES  FROM  OTHER  AP'S  IN  THE 

IISS  . 


GETNAM 

INICOH2  INITIALIZE  AP'S  CONNECTION  TO  THE  IISS. 

INITAL2  INITIALIZE  AP'S  CONNECTION  TO  THE  TIV  MTl,  . 

INITEX2  INITIALIZE  UI  LIKE  AP'S  CONNECTION  TO  IHE 
UIV  MPU. 

:NITIL2  INITIALIZE  AN  AP's  CONNECTlOtJ  TO  AN  AP 
SELECTED  MPU. 

MBXLOG  PURPOSE  NOT  KNOWN  -  ACTIVE  CODE. 

TRMNAX2  TERMINATE  COMM ' S  CONNECTION  TO  THE  IISS. 


INITAL 

RCLE  REMOTE  COMPILE  AND  LINK  EXPERT  DRl'.  ;  R 
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NTM/SERV  Where-external-routine-used  List 


System 

Module 

Module 

Module 

Name 

Purpose 

ISEND 

SNDRCLE 

REMOTE  COMPILE  AND  LINK  EXPERT  CALLING 

SERVICE 

LOCKEF 

INITAL2 

INITIALIZE  AP'S  CONNECTION  TO  THE  TIV  MPU 

NSEND 

FILGEN 

RCLE 

REMOTE  COMPILE  AND  LINK  EXPERT  DRIVER 

RCV 

FILGEN 

RCLE 

REMOTE  COMPILE  AND  LINK  EXPERT  DRIVER 

RCVMSG 

CHKMSG2 

TO  CHECK  FOR  MESSAGES  FROM  OTHER  APS  IN 

GDSEND2 

THE  IISS  . 

SEND  MESSAGES  THAT  REQUIRE  GUARANTEED 

INICOM2 

DELIVERY  PROCESSING. 

INITIALIZE  AP'S  CONNECTION  TO  THE  IISS. 

INITAL2 

INITIALIZE  AP'S  CONNECTION  TO  THE  TIV  MPU 

INITEX2 

INITIALIZE  UI  LIKE  AP'S  CONNECTION  TO  THE 

INITIL2 

UIV  MPU. 

INITIALIZE  AN  AP's  CONNECTION  TO  AN  AP 

ISEND2 

SELECTED  MPU. 

SEND  MESSAGE  THAT  WILL  CAUSE  THE  SPECIFIC 

NSEND2 

INITIATION  OF  AN  AP. 

SEND  MESSAGE  TO  AN  AP  IN  THE  IISS. 
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NTM/SERV  Where-external-routine-used  List 

System  Module  Module 

Module  Name  Purpose 


QSEND2  SEND  MESSAGES  TO  OTHER  APS  IN  THE  IISS 
FROM  QSERVER  AP ' S . 

RCV2  RECEIVE  MESSAGES  FROM  OTHER  AP'S  IN  THE 

IISS  . 


RELEVB 

GDSEND2  SEND  MESSAGES  THAT  REQUIRE  GUAPJ^NTEED 
DELIVERY  PROCESSING, 

INITAL2  INITIALIZE  AP'S  CONNECTION  TO  THE  TIV  MPU . 
INITIL2  INITIALIZE  AN  AP'S  CONNECTION  TO  AN  AF 
SELECTED  MPU. 

ISEND2  SEND  MESSAGE  THAT  WILL  CAUSE  THE  SPECIFIC 
INITIATION  OF  AN  AP. 

NSEND2  SEND  MESSAGE  TO  AN  AP  IN  THE  IISS. 

QSEND2  SEND  MESSAGES  TO  OTHER  APS  IN  THE  IISS 
FROM  QSERVER  AP'S. 

TRMNAT2  TERMINATE  AN  AP'S  CONNECTION  TO  THE  IISS. 
TRMNAX2  TERMINATE  COMM ' S  CONNECTION  TO  THE  IISS. 


SETTIM 

GDSEND2  SEND  MESSAGES  THAT  REQUIRE  GUARANTEED 
DELIVERY  PROCESSING. 

INICOM2  INITIALIZE  AP'S  CONNECTION  TO  THE  IISS. 

Ii:iTAL2  INITIALIZE  AP'S  CONNECTION  TO  THE  ITV  ML’’, 

INITEX2  INITIALIZE  UI  LIKE  AP'S  CONNECTIO!.’  TO  IHK 
UIV  MPU. 

INITIL2  INITIALIZE  AN  AP's  CONNECTION'  TO  AN  AP 
SELECTED  MPU. 

ISEND2  SEND  MESSAGE  THAT  WILL  CAUSE  IHE  SPECIFIC 
INITIATION  OF  AN  AP. 

NSEND2  SEND  MESSAGE  TO  AN  AP  IN  THE  IISS. 

QSEND2  SEND  MESSAGES  TO  OTHER  APS  Hi  Tr;E  IISS 
FROM  QSERVER  AP'S. 

RCLE  REMOTE  COMPILE  AND  LINK  EXPERT  DRIVER 

TRMNAT2  TERMINATE  AN  AP'S  CONNECTION  TO  THE  IISS. 
TRMNAX2  TERMINATE  COMM ' S  CONNECTION  TO  THE  IISS. 


PS  620342; 
30  September  19 


NTM/SERV  Where-external-routine-used  List 

System  Module  Module 

Module  Name  Purpose 


SNDMSG 

GDSEND2 

INICOM2 

INITAL2 

INITEX2 

INITIL2 

ISEND2 

NSEND2 

QSEND2 

TRMNAT2 

TRMNAX2 


SEND  MESSAGES  THAT  REQUIRE  GUARANTEED 
DELIVERY  PROCESSING. 

INITIALIZE  AP'S  CONNECTION  TO  THE  IISS. 
INITIALIZE  AP'S  CONNECTION  TO  THE  TIV  MPU . 
INITIALIZE  UI  LIKE  AP'S  CONNECTION  TO  THE 
UIV  MPU. 

INITIALIZE  AN  AP ' s  CONNECTION  TO  AN  AP 
SELECTED  MPU. 

SEND  MESSAGE  THAT  WILL  CAUSE  THE  SPECIFIC 
INITIATION  OF  AN  AP. 

SEND  MESSAGE  TO  AN  AP  IN  THE  IISS. 

SEND  MESSAGES  TO  OTHER  APS  IN  THE  IISS 
FROM  QSERVER  AP'S. 

TERMINATE  AN  AP'S  CONNECTION  TO  THE  IISS. 
TERMINATE  COMM ' S  CONNECTION  TO  THE  IISS. 


SYS$ASCTIM 

ASCTIM  CALLED  BY  MPU ' S  TO  GET  THE  SYSTEM  TIME  AS 
AN  ASCII  STRING. 


SYS$CREPRC 

RCLE  REMOTE  COMPILE  AND  LINK  EXPERT  DRIVER 


SYS$GETJPI 

RCLE  REMOTE  COMPILE  AND  LINK  EXPERT  DRIVER 


SYS$GETTIM 
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NTM/SERV  Where-external-routine-used  List 

System  Module  Module 

Module  Name  Purpose 


ASCTIM  CALLED  BY  MPU ' S  TO  GET  THE  SYSTEM  TIME  AS 
AN  ASCII  STRING. 

GETTIM  GET  THE  SYSTEM  TIME  AS  A  BINARY  STRING. 


WAITOl 

GDSEND2  SEND  MESSAGES  THAT  REQUIRE  GUARANTEED 
DELIVERY  PROCESSING. 

INICOM2  INITIALIZE  AP ' S  CONNECTION  TO  THE  IISS. 

INITAL2  INITIALIZE  AP ' S  CONNECTION  TO  THE  TIV  MPU. 

INITEX2  INITIALIZE  UI  LIKE  AP '  S  CONNECTIOI.  ^0  THE 
UIV  MPU. 

INITIL2  INITIALIZE  AN  AP ' s  CONNECTION  TO  AN  AP 
SELECTED  MPU. 

ISEND2  SEND  MESSAGE  THAT  WILL  CAUSE  THE  SPECIFIC 
INITIATION  OF  AN  AP. 

NSEND2  SEND  MESSAGE  TO  AN  AP  IN  THE  IISS. 

QSEND2  SEND  MESSAGES  TO  OTHER  APS  IN  THE  iISS 
FROM  QSERVER  AP'S. 

RCLE  REMOTE  COMPILE  AND  LINK  EXPERT  DRIVER 

RCV2  RECEIVE  MESSAGES  FROM  OTHER  AP'S  IN  THE 

IISS  . 

TRMNAT2  TERMINATE  AN  AP'S  CONNECTION  TO  THE  IISS. 

TRMNAX2  TERMINATE  COMM ' S  CONNECTION  TO  THE  IISS. 


WAT TO 2 

GDSEND2  SEND  MESSAGES  THAT  REQUIRE  GUARANTEED 
DELIVERY  PROCESSING. 

INICOH2  INITIALIZE  AP'S  CONNECTION  TO  THE  IISS. 

INITAL2  INITIALIZE  AP'S  CONNECTION  TO  THE  TIV  MPU. 

INITEX2  INITIALIZE  UI  LIKE  AP'S  CONNECTION  TO  THE 
UIV  MPU. 

INITIL2  INITIALIZE  AN  AP'S  CONNECTION  TO  AN  AP 
SELECTED  MPU. 

ISEND2  SEND  MESSAGE  THAT  WILL  CAUSE  THE  SPECIFIC 
INITIATION  OF  AN  AP. 

NSEND2  SEND  MESSAGE  TO  AN  AP  IN  THE  IISS. 
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PS  620342300 
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System 

Module 

Module 

Module 

Name 

Purpose 

QSEND2 

SEND  MESSAGES  TO  OTHER  APS  IN  THE  IISS 
FROM  QSERVER  AP ' S . 

RCV2 

RECEIVE  MESSAGES  FROM  OTHER  AP'S  IN  THE 
IISS  . 
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3.10.7  Main  Program  Parts  List 

The  following  lists  each  Main  Program  listed  in  3.10.1  a:.! 
all  the  modules  v.’hich  are  called  either  by  that  module  itselt  or 
by  any  of  the  documented  modules  which  it  calls.  It  is  possible 
for  a  non-main  module  to  be  listed  more  that  once  if  it  is 
called  by  multiple  modules.  The  called  modules,  in  this  case 
known  as  program  parts,  are  marked  as  to  whether  they  are 
documented  here.  If  so,  the  phrase' "well-defined  module" 
appears  by  the  module  name,  if  not  it  is  an  "external  "routir.o". 
The  Purpose  of  the  Main  Program  module  is  listed  as  well. 
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Main  Pgm 
Name 


ASCTIM 


PS  6  2  0  3  2  3  o; 
3  0  Septem.ber  IP-'u 


Module  Module 

Name  Type 


Purpose-->CALLED  BY  MPU ' S  TO  GET  THE 

SYSTEM  TIME  AS  AN  ASCII  STRING. 
SYS$ASCTIM  External  routine 

SYS$GETTIM  External  routine 
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Main  Pgm  Module  Module 

Name  Name  Type 


CHGR0L2  Purpose 

CNLTIH 

ERRPRO 

GETMSG 

NSEND2 

RCVHSG 

RELEVB 

SETTIM 

SNDMSG 

WAITOl 

WAIT02 


— >CHANGE  THE  ROLE  UNDER  WHICH  A 
USER  LOGGED  ON. 

External  routine 
External  routine 
External  routine 
Well-defined  module 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
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Main  Pgm 

Module 

Module 

Name 

Name 

Type 

CHKMSG2 

Purpose — >TO  CHECK  FOR  MESSAGES  FROM  OTHER 

APS  IN  THE  IISS  . 

ERRPRO 

External  routine 

GETMSG 

External  routine 

RCVMSG 

External  routine 
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PS  62 0  3-;  .MOO 
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Main  Pgm  Module  Module 

Mane  Name  Type 


FILGEN  Purpose--> 

.  ERRPRO  External  routine 

NSEND  External  routine 

RCV  External  routine 

I 

i 
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NTM/SERV  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

G PACK 2 

Purpose-->SENDS  GD 

ACK  MESSAGE  TO  LOCAL 

MPU . 

CNLTIM 

External 

routine 

ERRPRO 

External 

routine 

GETMSG 

External 

routine 

NSEND2 

Well-def 

ined  module 

RCVMSG 

External 

routine 

RELEVB 

External 

routine 

SETTIM 

External 

routine 

SNDMSG 

External 

routine 

WAITOl 

External 

routine 

WAIT02 

External 

routine 
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NTM/SERV  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

GDSEND2 

Purpose — >SEND  MESSAGES  THAT 
GUARANTEED  DELIVERY 

CNLTIH 

External 

routine 

ERRPRO 

External 

routine 

GETMSG 

External 

routine 

RCVMSG 

External 

routine 

RELEVB 

External 

routine 

SETTIM 

External 

routine 

SNDMSG 

External 

routine 

WAITOl 

External 

routine 

WAIT02 

External 

routine 

PROCESSIi; 


i-'i  1 
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NTM/SERV  Main  Program  Parts  List 


Main  Pgm 
Name 


Module 

Name 


Module 

Type 


GETTIM 


Purpose — >GET  THE  SYSTEM  TIME  AS  I 
STRING. 


SYS$GETTIM 


External  routine 


BINARY 
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NTH/SERV  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

GETUSR2 

Purpose — >RETURNS  ORIGINAL  SOURCE,  LOGICAL 
CHANNEL,  AND  USER  NAME. 

CNLTIM 

External  routine 

ERRPRO 

External  routine 

GETMSG 

External  routine 

NSEND2 

Well-defined  module 

RCV2 

Well-defined  module 

RCVMSG 

External  routine 

RELEVB 

External  routine 

SETTIM 

External  routine 

SNDMSG 

External  routine 

WAITOl 

External  routine 

WAIT02 

External  routine 

PS  6  2  0  3  4  2  :  U  C 
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NTM/SERV  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

INIC0M2 

Purpose — >INITIALIZE  AP ' S  CONNECTION  TO 

CRTMBX 

THE  IISS 
External 

routine 

ERRPRO 

External 

routine 

GETMSG 

External 

routine 

GETNAM 

External 

routine 

RCVMSG 

External 

routine 

SETTJM 

External 

routine 

SNDMSG 

External 

routine 

WAITOl 

External 

routine 

WAIT02 

External 

routine 
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NTM/SERV  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

FJame 

Name 

Type 

INITAL2 

Purpose — >INITIALIZE  AP'S  CONNECTION  TO 
THE  TIV  MPU. 

CRTMBX 

External 

routine 

DELMBX 

External 

routine 

ERRPRO 

External 

routine 

GETMSG 

External 

routine 

GETNAM 

External 

routine 

LOCKEF 

External 

routine 

RCVMSG 

External 

routine 

RELEVB 

External 

routine 

SETTIM 

External 

routine 

SNDMSG 

External 

routine 

WAITOl 

External 

routine 

WAIT02 

External 

routine 

NTM/SERV  Main  Program  Parts  List 


Main  Pgm 
Name 


INITEX2 


PS  620342300 
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Module  Module 

Name  Type 


Purpose-->INITIALIZE  UI  LIKE  AP ' S 


CRTMBX 

CONNECTION  TO  THE  UIV  MPU . 
External  routine 

DELMBX 

External 

routine 

ERRPRO 

External 

routine 

GETMSG 

External 

routine 

GETNAM 

External 

routine 

RCVMSG 

External 

routine 

SETTIM 

External 

routine 

SNDMSG 

External 

routine 

WAITOl 

External 

routine 

WAIT02 

External 

routine 
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NTM/SERV  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

INITIL2 

Purpose — >INITIALIZE  AN  AP ' s  CONNECTION  TO 
AN  AP  SELECTED  MPU . 

CRTMBX 

External 

routine 

DELMBX 

External 

routine 

ERRPRO 

External 

routine 

GETMSG 

External 

routine 

GETNAM 

External 

routine 

RCVMSG 

External 

routine 

RELEVB 

External 

routine 

SETTIM 

External 

routine 

SNDMSG 

External 

routine 

WAITOl 

External 

routine 

WAIT02 

External 

routine 

i--; 
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NTM/SERV  Main  Program  Parts  List 

Main  Pgm  Module  Module 

Name  Name  Type 


ISEND2  Purpose 

CNLTIM 

ERRPRO 

GETMSG 

RCVMSG 

RELEVB 

SETTIM 

SNDMSG 

WAITOl 

WAIT02 


-->SEND  MESSAGE  THAT  WILL  CAUSE  THE 
SPECIFIC  INITIATION  OF  AN  AP. 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
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NTM/SERV  Main  Program  Parts  List 

Main  Pgm  Module  Module 

Name  Name  Type 


LOGOFF2  Purpose 

CNLTIM 

ERRPRO 

GETMSG 

NSEND2 

RCVMSG 

RELEVB 

SETTIM 

SNDMSG 

WAITOl 

WAIT02 


->SENDS  LOGOFF  MESSAGE  TO  THE 
MONITOR  AP. 

External  routine 
External  routine 
External  routine 
Well-defined  module 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
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NTM/SERV  Main  Program  Parts  List 

Main  Pgm  Module  Module 

Name  Name  Type 


LOGON2  Purpose — >SENDS  LOGON  MESSAGE  TO  THE 


MONITOR  . 

AP. 

CNLTIM 

External 

routine 

ERRPRO 

External 

routine 

GETMSG 

External 

routine 

NSEND2 

Well-defined  module 

RCV2 

Well-defined  module 

RCVMSG 

External 

routine 

RELEVB 

External 

routine 

SETTIM 

External 

routine 

SNDMSG 

External 

routine 

WAITOl 

External 

routine 

WAIT02 

External 

routine 
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NTM/SERV  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

MBXLOG 

Purpose — >PURPOSE  NOT  KNOWN  -  ACTIVE  CODE 

GETNAM 

External  routine 

:  -  9 1 
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NTM/SERV  Main  Program  Parts  List 

Main  Pgm  Module  Module 

Name  Name  Type 


QSEND2 

CNLTIM 

ERRPRO 

GETMSG 

RCVMSG 

RELEVB 

SETTIM 

SNDMSG 

WAITOl 

WAIT02 


Purpose — >SEND  MESSAGES  TO  OTHER  APS  IN 
THE  IISS  FROM  QSERVER  AP'S. 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
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Main  Pgm 
Name 


RCLE 


Module  Module 

Name  Type 


Purpose — >REMOTE  COMPILE  AND  LINK  EXPERT 


DRIVER 

APACCT 

External  routine 

DELMBX 

External  routine 

ENDRUN 

External  routine 

ERRPRO 

External  routine 

INITAL 

External  routine 

NSEND 

External  routine 

POSTCOM 

Well-defined  module 

PRECOM 

Well-defined  module 

RCLFILE 

Well-defined  module 

RCV 

External  routine 

RELEVB 

External  routine 

SETTIM 

External  routine 

SNDMSG 

External  routine 

SYS$CREPRC 

External  routine 

SYS$GETJPI 

External  routine 

TRMNAT 

Well-defined  module 

TRMNAT2 

Well-defined  module 

WAITOl 

External  routine 

PS  620342 
30  September  1 


NTM/SERV  Main  Program  Parts  List 

Main  Pgm  Module  Module 

Name  Name  Type 


SIGABT2 


Purpose — >SIGNAL  THE  MPU  TO  ABORT 
AP 


CNLTIM 

External 

routine 

ERRPRO 

External 

routine 

GETMSG 

External 

routine 

NSEND2 

Well-defined  module 

RCVMSG 

External 

routine 

RELEVB 

External 

routine 

SETTIM 

External 

routine 

SNDMSG 

External 

routine 

WAITOl 

External 

routine 

V'JAIT02 

External 

routine 

CHILD 


3-54 


PS  620342300 
30  September  1990 


NTM/SERV  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

SIGERR  Purpo 

APACCT 
CNLTIM 
ERRPRO 
GETMSG 
NSEND2 
RCVMSG 
RELEVB 
SETTIM 
SIGERR2 
SNDMSG 
WAITOl 
WAIT02 


e — >CALL  SIGERR2 

External  routine 
External  routine 
External  routine 
External  routine 
Well-defined  module 
External  routine 
External  routine 
External  routine 
Well-defined  module 
External  routine 
External  routine 
External  routine 
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PS  620342300 
30  September  1990 


NTM/SERV  Main 

Main  Pgm  Module 
Name  Name 

SNDRCLE 

ISEND 


Program  Parts  List 

Module 

Type 


Purpose — >REMOTE  COMPILE  AND  LINK  EXPERT 
CALLING  SERVICE 
External  routine 


3-56 
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0  September 


NTM/SERV  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

TRMNAX 

Purpose — >CALL  TRMNAX2 

APACCT 

External 

routine 

ENDRUN 

External 

routine 

ERRPRO 

External 

routine 

GETNAM 

External 

routine 

RELEVB 

External 

routine 

SETTIM 

External 

routine 

SNDMSG 

External 

routine 

TRMNAX2 

Well-defined  module 

WAITOl 

External 

routine 

3-'// 
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NTM/SERV  Main  Program  Parts  List 


Main  Pgm  Module 
Name  Name 


Module 

Type 


TSTMOD  Purpose — >CALL  COBOL  ROUTINE  TSTMOD2 

APACCT  External  routine 

TSTM0D2  Well-defined  module 
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MTM/SERV  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

WHTHST 

Purpose — >CALL  WHTHST2 

APACCT 

External  routine 

CNLTIM 

External  routine 

ERRPRO 

External  routine 

GETMSG 

External  routine 

NSEND2 

Well-defined  module 

RCV2 

Well-defined  module 

RCVMSG 

External  routine 

RE LEV B 

External  routine 

SETTIM 

External  routine 

SNDMSG 

External  routine 

WAITOl 

External  routine 

WAIT 02 

External  routine 

WHTHST2 

Well-defined  module 

PS  62034  2'; 
3C  Scptonbcr  16 


3.10.8  Module  Documentation 

The  following  documentation  describes  information  which  in 
specific  to  each  individual  module  being  documented  in  this 
specification  as  listed  in  section  3.10.2.  It  provides  a 
compact  way  of  getting  information  that  would  be  otherwise 
buried  within  each  module's  source  code. 

The  specific  items  in  this  module  documentation  have  the 
follov/ing  meanings: 


NAME : 


PURPOSE : 


LANGUAGE : 


MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 

HOST: 

SUBSYSTEM: 
SUBDIRECTORY : 


Name  of  program  Module. 

Purpose  of  Module  as  detailed  in  the 
source  code. 

Programming  language  source  code  is 
written  in. 

The  choices  are: 

VAX- 11  FORTRAN 
C  (I/S-1  Workbench  ’C) 

VAX-11  COBOL 

Whether  a  Program,  Subroutine,  or 
Function. 

Name  of  Source  File  from  file 
specification. 

Source  File  Extension  from  file 
specification . 

Whether  this  is  a  host-dependent 
routine  (VAX  or  IBM)  or  blank  if 
host-independent . 

IISS  sub-system  this  file  resides  in. 

Sub-directory  of  that  subsystem  in 
which  this  file  resides. 


DOCUMENTATION  GROUP: 


DESCRIPTION: 


ARGUMENTS : 


INCLUDE  FILES: 


Name  of  dccum.entat ion  group  of  which 
this  source  file  is  a  member. 

A  description  of  the  module  as  otained 
from  the  source  code. 

The  arguments  with  which  this  routine 
is  called  if  it  is  a  Subroutine  or  a 
Function . 

A  list  of  all  the  files  that  are 
included  into  this  module  an  v.-ell  as 
their  purposes. 
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ROUTINES  CALLED: 


PS  62  C  3.;  2  3  00 
30  September  lOOo 


Subroutines  or  Functions,  either 
documented  or  external,  called  by 
this  module,  if  any. 

CALLED  DIRECTLY  BY:  The  documented  routines  v.'hich  call 

this  module,  if  any. 

USED  IN  MAIN  PROGRAM(S):  The  documented  Main  Programs  which 

contain  this  module  in  their  parts 
list  according  to  the  list  in  secticn 
3.10.7. 


The  Module  Documentation  is  arranged  alphabetically  acj.r'ii.'.a 
to  Module  Name. 


!  - ' .  i 
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NAME : 

PURPOSE: 

LANGUAGE: 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 


ASCTIM 

CALLED  BY  MPU ' S  TO  GET  THE  SYSTEM  TIME  AS 
AN  ASCII  STRING. 

VAX- 11  COBOL 

SUBROUTINE 

ASCTIM 

.  COB 

VAX 

NTM 

SERVICES 

NTMSERV 


DESCRIPTION: 


-  CALLS  VMS  SERVICES:  SYS$GETTIM 


SYS$ASCTIM 


ARGUMENTS : 


TIME-STRING  =  DSPLY  [X(23)] 
NTM-RETURN  =  DSPLY  [X(5)] 
SS-STATUS  =  DSPLY  [S9(9)] 


ROUTINES  CALLED: 


SYS$GETTIM 

SYS$ASCTIM 
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NTM/SERV  Module  Documentation 


NAME : 

PURPOSE: 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 


CHGROL2 

CHANGE  THE  ROLE  UNDER 
ON. 

VAX- 11  COBOL 
SUBROUTINE 
CHGROL2 
.  COB 

NTM 

SERVICES 

NTMSERV 


WHICH  A  USER  LOGGED 


DESCRIPTION: 


ARGUMEfJTS  : 


TERMINAL-ID  =  DSPLY  [X(3)] 

USER-NAME  =  DSPLY  [X(8)] 

ROLE-NAME  =  DSPLY  [X(10)] 

RTN-CODE  =  DSPLY  [X(5)] 
API-GLOBAL-NAME-SEC  =  RECRD 
API-GLOBAL-BUFFER-SEC  =  RECRD 
HOT-MBX-EVENT-BLK  =  DSPLY  [X(2032)] 
COLD-MBX-EVENT-BLK  =  DSPLY  [X(2032)] 
SEND-EVENT-BLK  =  DSPLY  [X(2032)] 
ACK-MBX-EVENT-BLK  =  DSPLY  rx(2032)] 
TIKER-EVENT-BLK  =  DSPLY  [X(80)] 


I.NCLUDE  FILES: 


SRVRET 
P.ETSTR 
SRVCD2 
APINME 
BUFAPI 
APIEVB 
ERR PRO 


AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 

THE  APIS  COMMON  LOCAL  DATA  FOR  ERROR-RETURNS. 

THAT  CALL  NSEND  AND  RCV 

****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

PROCESS  ERROR  INCLUDE  FILE 


ROUTirJES  CALLED: 


NSEI;D2  -  SEND  MESSAGE  TO  AN  AP  IN  THE  TISS. 

n- RPRO 
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NAME: 

PURPOSE: 

LANGUAGE: 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY: 
DOCUMENTATION  GROUP 

DESCRIPTION: 


CHKMSG2 

TO  CHECK  FOR  MESSAGES 
THE  IISS  . 

VAX-11  COBOL 
SUBROUTINE 
CHKMSG2 
.  COB 

NTM 

SERVICES 
:  NTMSERV 


FROM  OTHER  APS  IN 


ARGUMENTS: 


LOGICAL-CHANNEL  =  DSPLY  [X(3)] 
MSG-SOURCE  =  DSPLY  [X(10)] 
ACCEPT-STATUS  =  DSPLY  [X(5)] 
API-GLOBAL-NAME-SEC  =  RECRD 
API-GLOBAL-BUFFER-SEC  =  RECRD 
HOT-MBX-EVENT-BLK  =  DSPLY  [X(2032)] 
COLD-MBX-EVENT-BLK  =  DSPLY  [X(2032)] 
SEND-EVENT-BLK  =  DSPLY  [X(2032)] 
ACK-MBX-EVENT-BLK  =  DSPLY  [X(2032)] 
TIMER-EVENT-BLK  =  DSPLY  [X(80)] 
TEST-MODE-FLAG  ^  DSPLY  [X] 


INCLUDE  FILES: 


MSGSTR 

APILCL 

SRVCDS 

RETSTR 

APINME 

BUFAPI 

APIEVB 

TSTMDE 

ERRPRO 


PURPOSE 

THE  APIS  COMMON  LOCAL  DATA. 

SERVICE  CODES  FOR  THE  NTM  SERVICE  ROUTINES. 
THE  APIS  COMMON  LOCAL  DATA  FOR  ERROR-RETURNS. 
****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

SPACES  OR  0. 

PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


RCVMSG 

GETMSG 

ERRPRO 
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NAME : 

PURPOSE: 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 


ERRAPI 

PURPOSE  NOT  KNOWN 

VAX- 11  COBOL 

SUBROUTINE 

ERRAPI 

.  COB 

VAX 

NTM 

SERVICES 

NTMSERV 


ACTIVE  CODE. 


DESCRIPTION: 


ARGUMENTS : 


CALL-NAME  =  DSPLY  [X(6)] 
ROUTINE-NAME  =  DSPLY  [X(8)] 
RET-CODE  =  DSPLY  [X(5)] 
SS-STATUS  =  DSPLY  [S9(9)] 
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NAME: 

PURPOSE: 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 


FILGEN 

VAX- 11  COBOL 
SUBROUTINE 
FILGEN 
.  COB 

NTM 

SERVICES 

NTMSERV 


DESCRIPTION: 


THE  PURPOSE  OF  THIS  ROUTINE  IS  TO  ACT  AS  A 
GENERALIZED  INTERFACE  TO  THE  FILE  NAME 
QUEUE  SERVER. 

mod  for  release  2.0  to  return  a  ret-status 
WILL  ASK  FOR  AND  RECEIVE  A  BLOCK  OF  20  NAMES 
AND  HAND  THEM  OUT  TO  A  CALLER  1  AT  A  TIME. 

IF  INUT-HOST  NAME  IS  BLANK,  THEN  USE  THE 
CURRENT  HOST  AND  PASS  IT  BACK  TO  THE  CALLER. 

COPY  OF  GENFIL  RENAMED  AS  FILGEN  FOR  USE  IN  NTM. 


ARGUMENTS : 


FILE-HOST  =  DSPLY  [XXX] 


INCLUDE  FILES; 


SRVRET  -  AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 

ERRPRO  -  PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


NSEND 

RCV 

ERRPRO 
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IO  September  10'":' 


* 


NAME : 

PURPOSE: 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST : 

SUBSYSTEM: 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 


GDACK2 

SENDS  GD  ACK  MESSAGE  TO  LOCAL  MPU . 

VAX- II  COBOL 

SUBROUTINE 

GDACK2 

.  COB 

NTM 

SERVICES 

NTMSERV 


DESCRIPTION: 


SENDS  GD  ACK  MESSAGE  TO  LOCAL  MPU.  THIS  INFORMS 
THE  MPU  THAT  THE  AP  HAS  ACCEPTED  THE  GD  MESSAGE. 


ARGUMENTS : 


MESSAGE-SERIAL-NUMBER  =  DSPLY  [X(7)] 
RETCODE  =  DSPLY  rX(5)] 
API-GLOBAL-NAME-SEC  =  RECRD 
API-GLOBAL-BUFFER-SEC  =  RECRD 
HOT-MBX-EVENT-BLK  =  DSPLY  [X(2032)] 
COLD-MBX-EVENT-BLK  =  DSPLY  [X(2032)] 
SEND-EVENT-BLK  =  DSPLY  [X(2032)] 
ACK-MBX-EVENT-BLK  =  DSPLY  [X(2032)] 
TIMER-EVENT-BLK  =  DSPLY  [X(80)] 


Ii;CLUDE  FILES: 


SRVRET 
SRVCD2 
RETSTR 
APILCL 
APINME 
BUT  API 
APIEVB 
ERR PRO 


AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 
THAT  CALL  NSEND  AND  RCV 

THE  APIS  COMMON  LOCAL  DATA  FOR  Ei;ROR-Rt.  TURNS  . 
THE  APIS  CO.MMON  LOCAL  DATA. 

****  PURPOSE  NOT  FOUND  BY  STRIPLiR  **** 

****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


N:TND2  -  SEND  MESSAGE  I'O  AN  AP  IN  THE  I  ISO. 

ERR PRO 


I  - 1 , 


NTM/SERV  Module  Documentation 
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NAME: 

PURPOSE: 

LANGUAGE: 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 


GDSEND2 

SEND  MESSAGES  THAT  REQUIRE  GUARANTEED 
DELIVERY  PROCESSING. 

VAX- 11  COBOL 
SUBROUTINE 
GDSEND2 
.COB 

NTM 

SERVICES 

NTMSERV 


DESCRIPTION: 


ARGUMENTS: 


DSTINATION  =  DSPLY  [X(10)] 
LOGICAL-CHANNEL  =  DSPLY  [X(3)] 
TIMEOUT-VALUE  -  DSPLY  [X(15)] 
DATA-TYPE  =  DSPLY  [X] 

MESSAGE-TYPE  =  DSPLY  [X(2)] 

SEND-SIZE  =  DSPLY  [9(5)1 
USER-DATA  =  RECRD 
ACCEPT-STATUS  =  DSPLY  [X(5)] 

MESSZ ' E-SERIAL-NUMBER  =  DSPLY  [X(7)] 
API -GLOBAL-NAME-SEC  =  RECRD 
API-GLOBAL-BUFFER-SEC  =  RECRD 
HOT-MBX-EVENT-BLK  =  DSPLY  [X(2032)] 
COLD-MBX-EVENT-BLK  =  DSPLY  [X(2032)l 
SEND-EVENT-BLK  =  DSPLY  [X{2032)] 
ACK-MBX-EVENT-BLK  =  DSPLY  [X(2032)] 
TIMER-EVENT-BLK  =  DSPLY  [X(80)] 


INCLUDE  FILES: 


MSGSTR 
APILCL 
SR VCDS 
RETSTR 
APINME 
BUFAPI 
APIEVB 
ERR PRO 


PURPOSE 

THE  APIS  COMMON  LOCAL  DATA. 

SERVICE  CODES  FOR  THE  NTM  SERVICE  ROUTINES. 
THE  APIS  COMMON  LOCAL  DATA  FOR  ERROR-RETURNS. 
****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


SNDMSG 
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SETTIM 

WAITOl 

RCVMSG 

WAIT02 

GETMSG 

CNLTIM 

RELEVB 

ERRPRO 


PS  6  2  0  3  •;  2  :•  0  ( ' 

30  September  loon 
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NAME: 

PURPOSE: 

LANGUAGE: 

MODULE  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE; 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY : 


GETTIM 

GET  THE  SYSTEM  TIME  AS  A  BINARY  STRING. 

VAX- 11  COBOL 

SUBROUTINE 

GETTIM 

.  COB 

VAX 

NTM 

SERVICES 


DOCUMENTATION  GROUP:  NTMSERV 


DESCRIPTION: 


-  CALLS  VMS  SERVICES:  SYS$GETTIM 

THE  GET  TIME  SYSTEM  SERVICE  FURNISHES  THE  CURRENT  SYSTEM 
TIME  IN  64-BIT  FORMAT.  THE  SYSTEM  TIME  IS  UPDATED  EVERY 
10  MILLISECONDS,  AND  THE  TIME  IS  RETURNED  IN 
lOO-NANOSECOND  UNITS  FROM  THE  SYSTEM  BASE  TIME. 


ARGUMENTS: 


TIME-VALUE  =  DSPLY  [9(18)] 
NTM-RETURN  =  DSPLY  [X(5)] 
SS-STATUS  =  DSPLY  [S9(9)] 


ROUTINES  CALLED: 


SYS$GETTIM 
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NAME : 

PURPOSE: 

LANGUAGE: 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 


GETUSR2 

RETURNS  ORIGINAL  SOURCE, 
AND  USER  NAME. 

VAX- 11  COBOL 
SUBROUTINE 
GETUSR2 
.COB 

NTM 

SERVICES 

NTMSERV 


LOGICAL  CHANNEL, 


DESCRIPTION: 


RETURNS  ORIGINAL  SOURCE,  LOGICAL  CHANNEL,  AND 
USER  NAME  TO  THE  CALLING  AP.  NOTE:  USER  NAME 
IS  RETURNED  ONLY  IF  THE  ORIGINAL  SOURCE  AP 
IS  THE  USER  INTERFACE. 


ARGUMENTS : 


R-AP-NAME  ^  DSPLY  [X(10)] 
LOGICAL-CHANNEL  =  DSPLY  [X(3)] 
USER-NAME  =  DSPLY  [X(8)] 

ROLE-NAME  =  DSPLY  [X(10)] 

TERM-ID  =  DSPLY  [X(2)] 

GETUSR-RET  -  DSPLY  [X(5)] 
API-GLOBAL-NAME-SEC  =  RECRD 
API-GLOBAL-BUFFER-SEC  =  RECRD 
HOT-MBX-EVENT-BLK  =  DSPLY  [X(2032)] 
COLD-MBX-EVENT-BLK  ==  DSPLY  [X(2032)  ] 
SEND-EVENT-BLK  =  DSPLY  [X(2032)] 
ACK-MBX-EVENT-BLK  =  DSPLY  [X(2032)] 
TIMER-EVENT-BLK  =  DSPLY  [X(80)] 
TEST-MODE-FLAG  =  DSPLY  [X] 


lU'CLUDE  FILES: 


SRVRET 
SRVCD2 
RETSTR 
APINME 
BUFAPI 
APIEVB 
rSTMDE 
ERR PRO 


AS  THE  RETURN  GIVEN  A  TABLE-EULL,  ERROR 
THAT  CALL  NSEND  AND  RCV 

THE  APIS  COMMON  LOCAL  DATA  FOR  E}<R0R-RETUR:J:- . 
****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

SPACES  OR  0. 

PROCESS  ERROR  INCLUDE  FILE 


3-7  1 


ROUTINES 


NSEND2 

RCV2 

ERRPRO 


PS  62034  2  JO'./ 
30  September  1990 


CALLED: 


-  SEND  MESSAGE  TO  AN  AP  IN  THE  IISS. 

-  RECEIVE  MESSAGES  FROM  OTHER  AP ' S  IN  THE  IISS  . 
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NAME : 

PURPOSE: 

LANGUAGE: 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 


INICOM2 

INITIALIZE  AP’S  CONNECTION  TO  THE  IISS. 

VAX-11  COBOL 

SUBROUTINE 

INICOM2 

.  COB 

NTM 

SERVICES 

NTMSERV 


DESCRIPTION: 


argume::ts 


COMM-RCV-EVEiN'T-BLOCK  -  DSPLY  [X(2032)] 
INPUT-MBX-NAME  =  DSPLY  [X(14)] 
APC-HOT-MBX-NAME  =  DSPLY  [X(14)] 
APC-COLD-MBX-NAME  --  DSPLY  [X(14)l 
RET-STATUS  =  DSPLY  [X(5)] 

MPU-INSTANCE  =  DSPLY  [XX] 


INCLUDE  FILES: 


ALMSGH 

INICMD 

ERRPRO 


SPACES  OR  0. 

PROCESS  ERROR  INCLUDE  FILE 
PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


GETNAM 
CRTMBX 
SNDMSG 
SETTIM 
WAITOl 
RCVMSG 
■..■A1T0  2 
OETMSG 
F:  PR  PRO 


NTM/SERV  Module  Documentation 


PS  G  2  u  i  : 
3  0  Septomi.ef  i 


NAME : 

PURPOSE: 

LANGUAGE: 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 


INITAL2 

INITIALIZE  AP'S  CONNECTION  TO  THE  TIV  MPU. 

VAX- 11  COBOL 

SUBROUTINE 

INITAL2 

.  COB 


NTM 

SERVICES 

NTMSERV 


DESCRIPTION : 


ARGUMENTS : 


BUFFER  =  DSPLY  [X(4096)] 

BUFFER-SIZE  =  DSPLY  [9(5)] 

SYS-STATE  =  DSPLY  [X] 

USER-RET-CODE  =  DSPLY  [X(5)] 
API-GLOBAL-NAME-SEC  =  RECRD 
API-GLOBAL-BUFFER-SEC  -  RECRD 
HOT-MBX-EVENT-BLK  -  DSPLY  [X(2032)] 
COLD-MBX-EVENT-BLK  =  DSPLY  [X{2032)] 
SEND-EVENT-BLK  =  DSPLY  [X(2032)] 
ACK-MBX-EVENT-BLK  =  DSPLY  [X(2032)] 
TIMER-EVENT-BLK  =  DSPLY  [X(80)] 
TEST-MODE-FLAG  --  DSPLY  [XI 


INCLUDE  FILES: 


APIINI 

ALMSGH 

APILCL 

APCNM2 

SRVCDS 

RETSTR 

APINME 

BUFAPI 

APIEVB 

TSTMDE 

ERRPRO 


FOR  INITIATION  PURPOSES 
SPACES  OR  0. 

THE  APIS  COMMON  LOCAL  DATA. 

SERVICE  CODES  FOR  THE  NTM  SERVICE  ROUTINES. 
SERVICE  CODES  FOR  THE  NTM  SERVICE  ROUTINES. 
THE  APIS  COMMON  LOCAL  DATA  FOR  ERROR-RETURNS. 
****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

SPACES  OR  0. 

PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


I.OCKEF 

GETNAM 

CRTMI5X 


3-7  4 


PS  620342300 
30  September  1090 


RCVMSG 

SETTIM 

WAIT02 

GETMSG 

SNDMSG 

WAITOl 

DELiMBX 

RELEVB 

ERRPRO 


3-7  0 


PS  62  0  3.';:’ j'j' 
30  Septcnber 


NTM/SERV  Module  Documentation 


NAME: 

PURPOSE: 

LANGUAGE: 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY : 
DOCUMENTATION  GROU 


INITEX2 

INITIALIZE  UI  LIKE 
UIV  MPU. 

VAX-11  COBOL 
SUBROUTINE 
INITEX2 
.  COB 

NTM 

SERVICES 
:  NTMSERV 


'S  CONNECTION  TO  THE 


DESCRIPTION: 


ARGUMENTS : 


BUFFER  =  DSPLY  [X(9999) 1 
BUFFER-SIZE  =  DSPLY  [9(b)] 
USEF-RET-CODE  =  DSPLY  [X(5)] 
API-GLOBAL-NAME-SEC  =  RECRD 
API-GLOBAL-BUFFER-SEC  =  RECRD 
HOT-MBX-EVENT-BLK  =  DSPLY  [X(2032)] 
COID-MBX-EVENT-BLK  =  DSPLY  [X(2032)] 
SEND-EVENT-BLK  =  DSPLY  [X(2032)] 
ACK-MBX-EVENT-BLK  =  DSPLY  [X(2r)32)] 
TIMLR-EVENT-BLK  =  DSPLY  [X(80)] 
TEST-MODE-FLAG  =  DSPLY  [X] 


INCLUDE  FILES: 


APIINI 
AIJ-ISGH 
APILCL 
SR VCDS 
RETSTR 
APCNMl 
APINME 
BUFAPi 
APIEVB 
TSTMDE 
ERR PRO 


FOR  INITIATION  PURPOSES 
SPACES  OR  0. 

THE  APIS  COMMON  LOCAL  DATA. 

SERVICE  CODES  FOR  THE  NTM  SERVICE  ROUTINES. 
THE  APIS  COMMON  LOCAL  DATA  FOR  ERROR-RETURNS. 
APIS  GLOBAL  NAME  DATA. 

****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

SPACES  OR  0. 

PROCESS  ERROR  INCLUDE  FILE 


RuUTTNES  CALLED- 


GETNAM 

CRTMBX 

StJDMSG 


3-76 


PS  6  2  0  3  2  3  0  V 
30  September  lyoo 


SETTIM 

VJAITOl 

RCVMSG 

WAIT02 

GETMSG 

DELMBX 

ERRPRO 


3-7  7 


NTM/SERV  Module  Documentation 


PS  62  034  2  ;(>i  I 

3  0  September 


NAME : 

PURPOSE: 

LANGUAGE: 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 

DESCRIPTION  : 


INITIL2 

INITIALIZE  AN  AP's 
SELECTED  MPU . 

VAX- II  COBOL 

SUBROUTINE 

INITIL2 

.  COB 

VAX 

NTM 

SERVICES 

NTMSERV 


CONNECTION  TO  AN  AP 


ARGUMENTS: 


BUFFER  =  DSPLY  [X(4096)] 

BUFFER-SIZE  =  DSPLY  [9(5)1 
MPU-NAME  --  DSPLY  [X(3)] 

SYS-STATE  =  DSPLY  [X] 

USER-RET-CODE  =  DSPLY  [X(5)] 
YPI-GLOBAL-NAME-SEC  =  RECRD 
API-GLOBAL-BUFFER-SEC  =  RECRD 
HOT-MBX-EVENT-BLK  =  DSPLY  [X(2032)] 
COLD-MBX-EVENT-BLK  =  DSPLY  [X(2032)] 
SEND-EVENT-BLK  =  DSPLY  rX(2032)] 
ACK-MBX-EVENT-BLK  DSPLY  [X(2032)] 
TIMER-EVENT-BLK  =  DSPLY  [X(80)] 
TEST-MODE-FIV^G  -  DSPLY  'X] 


INCLUDE  FILES: 


APIINI 
ALMSGH 
APILCL 
APCNM2 
SRVCDS 
RETSTR 
APINME 
BUFAPI 
APIEVB 
TSTMDE 
ERR PRO 


FOR  INITIATION  PURPOSES 
SPACES  OR  0. 

THE  APIS  COMMON  LOCAL  DATA. 

SERVICE  CODES  FOR  THE  NTM  SERVICE  ROUTINES. 
SERVICE  CODES  FOR  THE  NTM  SERVICE  ROUTINES. 
THE  APIS  COMMON  LOCAL  DATA  FOR  ERROR-RETURNS. 
****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

SPACES  OR  0. 

PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


GETNAM 


3-78 


PS  62  0 
20  Septembe 


CRTMBX 

RCVMSG 

SETTIM 

WAIT02 

GETMSG 

SNDMSG 

WAITOl 

DELMBX 

RELEVB 

ERRPRO 


3-7  6 


PS  G2  0 
30  Septenbc 


NTM/SERV  Module  Documentation 


NAME : 

PURPOSE: 

LANGUAGE: 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 


INSTNC2 

GET  THE  SYSGEN  INSTANCE  NUMBER. 

VAX- 11  COBOL 

SUBROUTINE 

INSTNC2 

.  COB 

NTM 

SERVICES 

NTMSERV 


DESCRIPTION: 


ARGUMENTS : 


INSTANCE-NUMBER  ==  DSPLY  [XX] 
RET-STATUS  =  DSPLY  [X(5)] 
MPU-INSTANCE  =  DSPLY  [XX] 


3-80 


PS  62  0 i  uu 
30  September  lO'U' 


NTM/SERV  Module  Documentation 


NAME: 

PURPOSE: 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 


ISEND2 

SEND  MESSAGE  THAT  WILL  CAUSE  THE  SPECll 1C 

INITIATION  OF  AN 

VAX-11  COBOL 

SUBROUTINE 

ISEND2 

.COB 

NTM 

SERVICES 

NTMSERV 


DESCRIPTION: 


ARGUMENTS 


DSTINATION  -  DSPLY  [X(10)] 
LOGICAL-CHANNEL  =  DSPLY  [X(3)] 
TIMEOUT-VALUE  =  DSPLY  [X(15)] 
DATA-TYPE  -  DSPLY  [X] 


INCLUDE  FILES: 


MSGSTR 
APTLCL 
b  i< C  Db 
REISTR 
APINMF 
EDI  AP'I 
AM  El'B 
K HR PRO 


FUR POSE 

THE  APIS  COMMON  LOCAL  DAvTA . 

SERVICE  CODES  FOR  THE  NTM  SERVICE  ROUTIN'ES. 
IHE  APIS  COMMON  LOCAL  DATA  FOR  ERROR-RETURTi;;  . 
****  PURPOSE  tJOT  FOUND  BY  STRIPPER  **** 

****  PURF’OSE  NOT  FOUND  BY  STRIPPER  **** 

****  PURPOSE  NOT  FOUND  BY  SI  RIPPER  **** 

PROCESS  ERROR  INCLUDE  FIFE 


i-M' :  IMCl  CATTED: 


ST  I  I  IM 
.'A  1 1  0  1 
i'C'-'MCG 
V.AIT0  2 

CM  m;:c 
c-:;iTTM 

;  !■  TFM5 
;  HR I  HO 


3  -  B  1 


PS  6  2  0  3  4  2  '  Cl  ■ 
30  SeptcrPibor  1 


NTM/SERV  Module  Documentation 


NAME: 

PURPOSE: 

LANGUAGE: 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST : 

SUBSYSTEM: 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 


LOGOFF2 

SENDS  LOGOFF  MESSAGE  TO  THE  MONITOR  AP. 

VAX-11  COBOL 

SUBROUTINE 

LOGOFF2 

.  COB 

NTM 

SERVICES 

NTMSERV 


DESCRIPTION: 


ACCEPTS  LOGOFF  DATA  FROM  THE  UI  AND  FORWARDS 
A  MESSAGE  TO  THE  MONITOR  AP  FOR  UPDATING  THE 
IISS  LOGON  TABLE. 


ARGUMENTS : 


TERMINAL-ID  =  DSPLY  [X(2)] 

USER-NAME  =  DSPLY  ^^(8)] 

ROLE-NAME  =  DSPLY  [X(10)] 
LOG-RET-CODE  =  DSPLY  [X(5)] 
API-GLOBAL-NAME-SEC  =  RECRD 
API-GLOBAL-BUFFER-SEC  =  RECRD 
HOT-MBX-EVENT-BLK  =  DSPLY  [X(2032)] 
COLD-MBX-EVENT-BLK  =  DSPLY  [X(2032) ] 
SEND-EVENT-BLK  =  DSPLY  [X{2032)] 
ACK-MBX-EVENT-BLK  =  DSPLY  [X(2032)] 
TIMER-EVENT-BLK  =  DSPLY  rX(80)] 


INCLUDE  FTTFS; 


SRVRET 

SRVCD2 

RETSTR 

APINME 

BUFAPI 

APIEVB 

ERRPRO 


AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 
THAT  CALL  NSEND  AND  RCV 

THE  APIS  COMMON  LOCAL  DATA  FOR  ERROR-RETURN'S. 
****  PURPOSE  NOT  FOUND  BY  STRTPPFR  **** 

****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

****  PURPOSE  I]OT  FOUND  BY  STRIPPER  **** 

PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


NSEND2  -  SEND  MESSAGE  TO  AN  AP  IN  THE  IISS. 

ERRPRO 


3-82 


PS  6  2  0  3  4  2  3  0  U 
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NTM/SERV  Module  Documentation 


MAME : 

PURPOSE: 

LANGUAGE: 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 


LOGON 2 

SENDS  LOGON  MESSAGE  TO  THE  MONITOR  AP. 

VAX- 11  COBOL 

SUBROUTINE 

LOGON2 

.COB 

NTM 

SERVICES 

NTMSERV 


DESCRIPTION: 


ACCEPTS  LOGON  DATA  FROM  THE  UI  AND  FORWARDS 
A  MESSAGE  TO  THE  MONITOR  AP  FOR  UPDATING  THE 
IISS  LOGON  TABLE.  WAITS  ON  THE  RESPONSE  FROM 
MONITOR  BEFORE  RETURNING  CONTROL  TO  THE  UI . 


ARGUMENTS : 


TERMINAL-ID  =  DSPLY  [X(2)] 

USER-NAME  =  DSPLY  [X(8) ] 

ROLE-NAME  =  DSPLY  [X(10)] 
SESSION-START-TIME  =  DSPLY  [X(23)] 
CHAN-RANGE-START  =  DSPLY  [X(3)] 
CHAN-RANGE-END  =  DSPLY  [X(3)] 
LOG-RET-CODE  =  DSPLY  [X(5)] 

API -GLOBAL-NAME-SEC  =  RECRD 
APl-GLOBAL-BUFFER-SEC  =  RECRD 
HOT-MBX-EVENT-BLK  -  DSPLY  [X(2032)] 
COLD-MBX-EVENT-BLK  =  DSPLY  [X(2032)] 
SEND-EVENT-BLK  =  DSPLY  [X(2032)] 
ACK-MBX-EVENT-BLK  =  DSPLY  [X(2032)] 
TIMER-EVENT-BLK  =  DSPLY  [X(80)] 
TEST-MODE-FLV\G  DSPLY  fX! 


:DE  FILEi 


SRVRET 
PETSTR 
S  f<VCD2 
APINME 
B'JFAPI 
AFIEVB 

i;;tmde 

FRRFRO 


AS  THE  RETURIi  GIVEN  A  TABF.E-FFT.L  ERROR 

THE  APIS  COMMON  LOCAL  DATA  FOR  ERROR-RF'I '  RNF  . 

THAT  CALL  NSEND  AND  RCV 

****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

****  PURPOSE  N'OT  FOUND  BY  STRIPPFR  **** 

****  PURPOSE  NOT  FOUND  BY  STRIPPFR  **** 

SE'ACFS  OR  0. 

PROCESS  ERROR  INCLUDE  FILE 


3-8  3 


ROUTINES  CALLED: 


PS  62  0  3-;  2  3  0'' 
3  0  September 


NSEND2 

RCV2 

ERRPRO 


SEND  MESSAGE  TO  AN  AP  IN  THE  IISS. 

RECEIVE  MESSAGES  FROM  OTHER  AP ' S  IN  THE  IISS 


3-84 


PS  620  34  ?  >r'i> 

30  September  lOOo 


NTM/SERV  Module  Documentation 


NAME:  MBXLG2 

PURPOSE:  PURPOSE  NOT  KNOIVN  -  ACTIVE  CODE. 

LANGUAGE:  VAX- 11  COBOL 

MODULE  TYPE:  SUBROUTINE 

SOURCE  FILE:  MBXLG2 

SOURCE  FILE  TYPE:  .COB 

HOST: 

SUBSYSTEM:  NTM 

SUBDIRECTORY:  SERVICES 

DOCUMENTATION  GROUP:  NTMSERV 

DESCRIPTION: 


ARGUMENTS : 


CALL-NAME  =  DSPLY  [X(72)] 


"> 

'  —  O 


PS  62  0'J 
3  0  Scpte  ibe  r 


NTM/SERV  Module  Documentation 


NAME: 

PURPOSE: 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 


MBXLOG 

PURPOSE  NOT  KNOWN 
VAX- 11  COBOL 
SUBROUTINE 
MBXLOG 
.  COB 

NTM 

SERVICES 

NTMSERV 


ACTIVE  CODE. 


DESCRIPTION: 


ARGUMENTS : 

MSG-BUFFER  =  DSPLY  [X(72)] 

ROUTINES  CALLED: 

GETNAM 


3-8f3 


PS  62  0  3-; 5  00 
30  September  ["''O 


NTM/SERV  Module  Documentation 


NAME  : 

PURPOSE: 

LANGUAGE: 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 


NSi:ND2 

SEND  MESSAGE  TO  AN  AP  IN  THE  IISS. 

VAX- 11  COBOL 

SUB..OUTINE 

NSEND2 

.  COB 

NTM 

SERVICES 

NTMSERV 


DESCRIPTION: 


ARGUMENTS : 


DSTINATION  =  DSPLY  [X(10)] 
LOGICAL-CHANI.'EL  =  DSPLY  [X(3)] 
TIMEOUT-VALUE  -  DSPLY  [X(15)] 
DATA-TYPE  =  DSPLY  [X] 


INCLUDE  FILES: 


MSGSTR 
APILCL 
SRVCDS 
REI'STR 
APir.’ME 
BUFAPI 
APIEVB 
ERR PRO 


PURPOSE 

IliE  APIS  COMMON  LOCAL  DATA. 

SERVICE  CODES  FOR  THE  NTM  SERVICE  ROLTINE;,'. . 
IHE  APIS  COMMON  LOCAL  DATA  FOR  ERROR-RETURNS. 
****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

PROCESS  ERROR  INCLUDE  FILE 


ROUIINES  CALLED: 


SNDMSG 
SETTIM 
WAIT 01 
i'iCVMSG 
WA1T02 
GK'I  MSG 
CNLTIM 
i-T-LEVB 
ERR PRO 


■VA;  RED  DIRKCILY  BY: 


CHGROL2  -  CHANGE  THE  ROLE  UNDER  WHICH  A 


■Gi  D  I . 


5-8  7 


PS  62 034 2 3  GO 
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GDACK2 

GETUSR2 

LOGOFF2 

LOGON2 

SIGABT2 

SIGERR2 

WHTHST2 


USED  IN  MAIN 


CHGROL2 

GDACK2 

GETUSR2 

LOGOFF2 

LOGON2 

SIGABT2 

SIGERR 

WHTHST 


-  SENDS  GD  ACK  MESSAGE  TO  LOCAL  MPU . 

-  RETURNS  ORIGINAL  SOURCE,  LOGICAL  CHANNEL,  AND 

USER  NAME. 

-  SENDS  LOGOFF  MESSAGE  TO  THE  MONITOR  AP. 

-  SENDS  LOGON  MESSAGE  TO  THE  MONITOR  AP. 

-  SIGNAL  THE  MPU  TO  ABORT  A  CHILD  AP 

-  SENDS  AN  ERROR  MESSAGE  TO  MONITOR  AND  TO 

ORIGINAL  SOURCE. 

-  RETURNS  THE  NAME  OF  THE  HOST  ON  WHICH  AN  AP 

RESIDES . 


PROGRAM (S) : 


-  CHANGE  THE  ROLE  UNDER  WHICH  A  USER  LOGGED  ON. 

-  SENDS  GD  ACK  MESSAGE  TO  LOCAL  MPU. 

-  RETURNS  ORIGINAL  SOURCE,  LOGICAL  CHANNEL,  AND 

USER  NAME. 

-  SENDS  LOGOFF  MESSAGE  TO  THE  MONITOR  AP. 

-  SENDS  LOGON  MESSAGE  TO  THE  MONITOR  AP. 

-  SIGNAL  THE  MPU  TO  ABORT  A  CHILD  AP 

-  CALL  SIGERR2 

-  CALL  WHTHST2 


3-88 


PS  620342300 
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NTM/SERV  Module  Documentation 


NAME: 

PURPOSE: 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 


POSTCOM 

VAX- 11  COBOL 
SUBROUTINE 
POSTCOM 
.COB 

NTM 

SERVICES 

NTMSERV 


DESCRIPTION: 


ARGUMENTS : 

FILENAM  =  DSPLY  [X(30)] 

ROUTINES  CALLED: 

RCLFILE 


CALLED  DIRECTLY  BY: 


RCLE  -  REMOTE  COMPILE  AND  LINK  EXPERT  DRIVER 

USED  IN  MAIN  PROGRAM(S): 

RCLE  -  REMOTE  COMPILE  AND  LINK  EXPERT  DRIVER 


3-89 


PS  620342300 
30  September  1990 


NTM/SERV  Module  Documentation 


NAME: 

PURPOSE: 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 


PRECOM 

VAX- 11  COBOL 
PROGRAM 
PRECOM 
.COB 

NTM 

SERVICES 

NTMSERV 


DESCRIPTION: 


ROUTINES  CALLED: 

RCLFILE 

CALLED  DIRECTLY  BY: 

RCLE  -  REMOTE  COMPILE  AND  LINK  EXPERT  DRIVER 

USED  IN  MAIN  PROGRAM(S): 

rCLE  -  REMOTE  COMPILE  AND  LINK  EXPERT  DRIVER 


3-90 


PS  620342300 
30  September  1990 


NTM/SERV  Module  Documentation 


NAME: 

PURPOSE: 

LANGUAGE: 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 


QSEND2 

SEND  MESSAGES  TO  OTHER  APS  IN  THE  IISS 
FROM  QSERVER  AP'S. 

VAX- 11  COBOL 
SUBROUTINE 
QSEND2 
.COB 

NTM 

SERVICES 

NTMSERV 


DESCRIPTION: 


THIS  ROUTINE  IS  A  PRELIMINARY  VERSION  OF  THE  SEND* 
SERVICE  FOR  THE  QSERVER.  CURRENTLY,  IT  ONLY  * 

SUPPORTS  QSERVERS  THAT  SERVICE  ONE  REQUEST  AT  A  * 
TIME.  * 


ARGUMENTS: 


DSTINATION  DSPLY  [X(10)] 
LOGICAL-CHANNEL  =  DSPLY  [X(3)] 
TIMEOUT-VALUE  =  DSPLY  [X(15)] 
DATA-TYPE  =  DSPLY  [X] 

MESSAGE-TYPE  =  DSPLY  [X(2)] 

SEND-SIZE  =  DSPLY  [9(5)] 

USER-DATA  =  RECRD 
ACCEPT-STATUS  =  DSPLY  [X(5)] 
API-GLOBAL-NAME-SEC  =  RECRD 
API-GLOBAL-BUFFER-SEC  =  RECRD 
HOT-MBX-EVENT-BLK  =  DSPLY  [X{2032)] 
COLD-MBX-EVENT-BLK  =  DSPLY  [X(2032)] 
SEND-EVENT-BLK  =  DSPLY  [X(2032)] 
ACK-MBX-EVENT-BLK  =  DSPLY  [X(2032)] 
TIMER-EVENT-BLK  =  DSPLY  [X(80)] 


INCLUDE  FILES: 


MSGSTR 

APILCL 

SRVCDS 

RETSTR 

APINME 

BUFAPI 

APIEVB 

FRRPRO 


PURPOSE 

THE  APIS  COMMON  LOCAL  DATA. 

SERVICE  CODES  FOR  THE  NTM  SERVICE  ROUTINES. 
THE  APIS  COMMON  LOCAL  DATA  FOR  ERROR-RETURNS. 
****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

PROCESS  ERROR  INCLUDE  FILE 


3-91 


PS  620342300 
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ROUTINES  CALLED: 


SNDMSG 

SETTIM 

WAITOl 

RCVMSG 

WAIT02 

GETMSG 

CNLTIM 

RELEVB 

ERRPRO 


PS  620342300 
30  September  1990 


NTM/SERV  Module  Documentation 


NAME: 

PURPOSE: 

LANGUAGE: 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 


RCLE 

REMOTE  COMPILE  AND  LINK  EXPERT  DRIVER 

VAX- 11  COBOL 

PROGRAM 

RCLE 

.COB 

VAX 

NTM 

SERVICES 

NTMSERV 


DESCRIPTION: 


RCLE  IS  INITIATED  BY  "SNDRCLE"  NTM  SERVICE.  IT  BUILDS  A  * 
COMMAND  FILE  WHICH  INCLUDES  THE  SYSTEM  CONTROL  CARDS  FOUND 
IN  THE  INITIATING  MESSAGE.  THIS  COMMAND  FILE  IS  THEN  RUN  AS 
A  DETACHED  PROCESS.  WHEN  IT  COMPLETES,  RCLE  WILL  RETURN  A 
MESSAGE  CONTAINING  THE  NAME  OF  THE  LOG  FILE. 

MODIFIED:  7/19/85  TO  NOT  CALL  GETUSER.  IT  NOW  REPLIES  TO 

RCV. 


INCLUDE  FILES: 


SRVRET  -  AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 

APILCL  -  THE  APIS  COMMON  LOCAL  DATA. 

APIEVB  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

RETSTR  -  THE  APIS  COMMON  LOCAL  DATA  FOR  ERROR-RETURNS. 

ERRPRO  -  PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


INITAL 

RCV 

RCLFILE 

PRECOM 

POSTCOM 

SYS$GETJPI 

SYSSCREPRC 

SETTIM 

WAITOl 

NS  END 

TRMNAT  -  CALL  TRMNAT2 

ERRPRO 


3-93 


PS  620342300 
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NTM/SERV  Module  Documentation 


NAME: 

PURPOSE: 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 


RCLFILE 

VAX-11  COBOL 
SUBROUTINE 
RCLFILE 
.COB 

NTM 

SERVICES 

NTMSERV 


DESCRIPTION: 


ARGUMENTS : 


C-CARD  =  DSPLY  [X(72)] 
REQUEST  =  DSPLY  [X(5)] 


CALLED  DIRECTLY  BY: 


POSTCOM 

PRECOM 

RCLE  -  REMOTE  COMPILE  AND  LINK  EXPERT  DRIVER 


USED  IN  MAIN  PROGRAM (S): 

RCLE  -  REMOTE  COMPILE  AND  LINK  EXPERT  DRIVER 


3-94 


PS  6203423U0 
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NTM/SERV  Module  Documentation 


NAME: 

PURPOSE: 

LANGUAGE: 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 


RCV2 

RECEIVE  MESSAGES  FROM  OTHER  AP'S  IN  THE 
IISS  . 

VAX-11  COBOL 
SUBROUTINE 
RCV2 
•  COB 

NTM 

SERVICES 

NTMSERV 


DESCRIPTION: 


ARGUMENTS: 


LOGICAL-CHANNEL  =  DSPLY  [X(3)] 
WAIT-FLAG  =  DSPLY  [X] 

MSG-SOURCE  =  DSPLY  [X(10)] 
MESSAGE-TYPE  =  DSPLY  [X(2)] 
DATA-LENGTH  =  DSPLY  [9(5)] 

USER-DATA  =  RECRD 
ACCEPT-STATUS  =  DSPLY  [X(5)] 
MSG-SERIAL-NUMBER  =  DSPLY  [X(7)] 
API-GLOBAL-NAME-SEC  =  RECRD 
API-GLOBAL-BUFFER-SEC  =  RECRD 
HOT-MBX-EVENT-BLK  =  DSPLY  [X(2032)] 
COLD-MBX-EVENT-BLK  =  DSPLY  [X(2032)] 
SEND-EVENT-BLK  =  DSPLY  [X(2032)] 
ACK-MBX-EVENT-BLK  =  DSPLV  [X(2032)] 
TIMER-EVENT-BLK  =  DSPLY  [X(80)] 
TEST-MODE-FLAG  =  DSPLY  [X] 


INCLUDE  FILES: 


MSGSTR 

APILCL 

SRVCDS 

RETSTR 

APINME 

BUFAPI 

APIEVB 

TSTMDE 

ERRPRO 


PURPOSE 

THE  APIS  COMMON  LOCAL  DATA. 

SERVICE  CODES  FOR  THE  NTM  SERVICE  ROUTINES. 
THE  APIS  COMMON  LOCAL  DATA  FOR  ERROR-RETURNS. 
****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

SPACES  OR  0. 

PROCESS  ERROR  INCLUDE  FILE 
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ROUTINES  CALLED: 


RCVMSG 

WAIT02 

WAITOl 

GETMSG 

ERRPRO 


CALLED  DIRECTLY  BY; 


GETUSR2  -  RETURNS  ORIGINAL  SOURCE,  LOGICAL  CHANNEL,  AND 

USER  NAME. 

LOGON2  -  SENDS  LOGON  MESSAGE  TO  THE  MONITOR  AP. 

WHTHST2  -  RETURNS  THE  NAME  OF  THE  HOST  ON  WHICH  AN  AP 

RESIDES . 


USED  IN  MAIN  PROGRAM (S) : 


GETUSR2  -  RETURNS  ORIGINAL  SOURCE,  LOGICAL  CHANNEL,  AND 

USER  NAME. 

LOGON2  -  SENDS  LOGON  MESSAGE  TO  THE  MONITOR  AP. 

WHTHST  -  CALL  WHTHST2 
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NTM/SERV  Module  Documentation 


NAME: 

PURPOSE: 

LANGUAGE: 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 


SIGABT2 

SIGNAL  THE  MPU  TO  ABORT  A  CHILD  AP 

VAX- 11  COBOL 

SUBROUTINE 

SIGABT2 

.  COB 

NTM 

SERVICES 

NTMSERV 


DESCRIPTION: 


NTM  SERVICE  TO  SIGNAL  ABORT  CHILD  TO  THE  MPU.  * 

AFTER  THIS  PROCESS,  THE  MPU  PROCESS  "ABORT"  TAKES  OVER.  * 


TELL  THE  LOCAL  MPU  TO  ABORT  A  CHILD.  THE  CHILD  MAY  BE  ON 
THE  SAME  OR  DIFFERENT  CLUSTER/HOST. 

ARGUMENTS: 


AP-NAME  =  DSPLY  [X(10)] 


INCLUDE  FILES: 


SRVRET 

RETSTR 

SRVCD2 

APILCL 

APINME 

BUFAPI 

APIEVB 

TSTMDE 

ERRPRO 


AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 
THE  APIS  COMMON  LOCAL  DATA  FOR  ERROR-RETURNS. 
THAT  CALL  NSEND  AND  RCV 
THE  APIS  COMMON  LOCAL  DATA. 

****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

SPACES  OR  0. 

PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


NSEND2  -  SEND  MESSAGE  TO  AN  AP  IN  THE  IISS. 

ERRPRO 
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NTM/SERV  Module  Documentation 


NAME: 

PURPOSE: 

LANGUAGE : 

MODULE  TYPE: 

FUNCTION  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 


SIGERR 

CALL  SIGERR2 

C 

FUNCTION 
INT  0 
SIGERR 

.C 

NTM 

SERVICES 

NTMSERV 


DESCRIPTION: 


SYNOPSIS 

CALL  SIGERR  USING  ERROR-CODE, 

SEVERITY-LEVEL, 
ERROR-DESCRIPTION , 
RETURN-CODE. 


INPUTS/OUTPUTS: 

INPUTS: 

ERROR-CODE  PIC  X(5). 
SEVERITY-LEVEL  PIC  X. 
ERROR-DESCRIPTION  PIC  X(72). 


OUTPUTS : 

RETURN-CODE  PIC  X(5). 


DESCRIPTION 

SIGERR  IMPLIMENTS  A  TWO-STEP  CALL  TO  SIGERR2 , 
ADDING  THE  ADDRESSES  OF  GLOBAL  AREAS  TO  THE 
PARAMETER  LIST  (IBM  COBOL  DOESN'T  ALLOW  EXTERNAL 
DATA  AREAS) . 


ARGUMENTS: 


A  =  CHAR  * 
B  =  CHAR  * 
C  =  CHAR  * 
D  =  CHAR  * 


INCLUDE  FILES: 


APINME 

—  ★  ★  ★  ★ 

PURPOSE 

NOT 

FOUND 

BY 

STRIPPER 

**** 

BUFAPI 

-  *  *  *  * 

PURPOSE 

NOT 

FOUND 

BY 

STRIPPER 

•k  "k  -k  -k 

APIEVB 

—  *■*:•>:* 

PURPOSE 

NOT 

FOUND 

BY 

STRIPPER 

*  *  *  * 
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ROUTINES  CALLED: 


APACCT 

SIGERR2  -  SENDS  AN  ERROR  MESSAGE  TO  MONITOR  AND  TO 

ORIGINAL  SOURCE. 
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NTM/SERV  Module  Documentation 


NAME: 

PURPOSE: 

LANGUAGE: 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 


SIGERR2 

SENDS  AN  ERROR  MESSAGE  TO  MONITOR  AND  TO 
ORIGINAL  SOURCE. 

VAX- 11  COBOL 
SUBROUTINE 
SIGERR2 
•  COB 

NTM 

SERVICES 

NTMSERV 


DESCRIPTION: 


ACCEPTS  ERROR  DATA  FROM  AN  AP  AND  FORWARDS  * 
A  MESSAGE  TO  THE  MONITOR  AP  FOR  ITS  ERROR  * 
REPORTING  AND  ONE  TO  THE  ORIGINAL  SOURCE  OF  THE  * 
AP.  * 


ARGUMENTS : 


ERROR-CODE  =  DSPLY  [X(5)] 
SEVERITY-LEVEL  =  DSPLY  [X] 
ERROR-DESCRIPTION  =  DSPLY  [X(72)] 
RTN-CODE  =  DSPLY  [X(5)] 
API-GLOBAL-NAME-SEC  =  RECRD 
API-GLOBAL-BUFFER-SEC  =  RECRD 
HOT-MBX-EVENT-BLK  =  DSPLY  [X(2032)] 
COLD-MBX-EVENT-BLK  =  DSPLY  [X(2032)] 
SEND-EVENT-BLK  =  DSPLY  [X(2032)] 
ACK-MBX-EVENT-BLK  =  DSPLY  [X(2032)] 
TIMER-EVENT-BLK  =  DSPLY  [X(80)] 


INCLUDE  FILES: 


SRVRET 

RETSTR 

SRVCD2 

APILCL 

APINME 

BUFAPI 

APIEVB 

ERRPRO 


AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 
THE  APIS  COMMON  LOCAL  DATA  FOR  ERROR-RETURNS. 
THAT  CALL  NSEND  AND  RCV 
THE  APIS  COMMON  LOCAL  DATA. 

****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


NSEND2  -  SEND  MESSAGE  TO  AN  AP  IN  THE  IISS. 

ERRPRO 
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CALLED  DIRECTLY  BY; 


SIGERR  -  CALL  SIGERR2 

USED  IN  MAIN  PROGRAM(S): 
SIGERR  -  CALL  SIGERR2 
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NTM/SERV  Module  Documentation 


NAME: 

PURPOSE: 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 

DESCRIPTION: 


SNDRCLE 

REMOTE  COMPILE  AND 

SERVICE 

VAX-11  COBOL 

SUBROUTINE 

SNDRCLE 

.  COB 

NTM 

SERVICES 

NTMSERV 


LINK  EXPERT  CALLING 


ARGUMENTS : 


NODE  =  DSPLY  [X(3) ] 

CHANNEL  =  DSPLY  [X(3)] 
CTL-CARD  =  DSPLY  [X(1096)] 
RET-STATUS  =  DSPLY  [X(5)] 


INCLUDE  FILES: 

SRVRET  -  AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 


ROUTINES  CALLED: 
ISEND 
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NTM/SERV  Module  Documentation 


NAME: 

PURPOSE: 

LANGUAGE : 

MODULE  TYPE: 

FUNCTION  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 


TRMNAT 

CALL  TRMNAT2 

C 

FUNCTION 
INT  0 
TRMNAT 

.C 

NTM 

SERVICES 

NTMSERV 


DESCRIPTION: 


SYNOPSIS 

CALL  TRMNAT  USING  USER-TERMINATE-STATUS . 


INPUTS/OUTPUTS: 

INPUTS: 

USER-TERMINATE-STATUS  PIC  X. 


OUTPUTS: 

DESCRIPTION 

TRMNAT  IMPLIMENTS  A  TWO-STEP  CALL  TO  TRMNAT2 , 
ADDING  THE  ADDRESSES  OF  GLOBAL  AREAS  TO  THE 
PARAMETER  LIST  (IBM  COBOL  DOESN'T  ALLOW  EXTERNAL 
DATA  AREAS) . 


ARGUMENTS: 


A  =  CHAR  * 


INCLUDE  FILES: 


APINME  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

APIEVB  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 


ROUTINES  CALLED: 


APACCT 

TRMNAT2  -  TERMINATE  AN  AP'S  CONNECTION  TO  THE  IISS. 


CALLED  DIRECTLY  BY : 


RCLE  -  REMOTE  COMPILE  AND  LINK  EXPERT  DRIVER 
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USED  IN  MAIN  PROGRAM (S): 

RCLE  -  REMOTE  COMPILE  AND  LINK  EXPERT  DRIVER 
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NTM/SERV  Module  Documentation 


NAME: 

PURPOSE: 

LANGUAGE: 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 


TRMNAT2 

TERMINATE  AN  AP'S  CONNECTION  TO  THE  IISS. 

VAX- 11  COBOL 

SUBROUTINE 

TRMNAT2 

.COB 

NTM 

SERVICES 

NTMSERV 


DESCRIPTION: 


ARGUMENTS : 


USER-TERMINATE-STATUS  =  DSPLY  [X] 
API-GLOBAL-NAME-SEC  =  RECRD 
HOT-MBX-EVENT-BLK  =  DSPLY  [X(2032)] 
COLD-MBX-EVENT-BLK  =  DSPLY  [X(2032)l 
SEND-EVENT-BLK  =  DSPLY  [X(2032)] 
ACK-MBX-EVENT-BLK  =  DSPLY  [X(2032)] 
TIMER-EVENT-BLK  =  DSPLY  [X(80)] 


INCLUDE  FILES: 


ADMSGH 

APILCL 

SRVCDS 

RETSTR 

APINME 

APIEVB 

ERRPRO 


THE  APIS  COMMON  LOCAL  DATA  FOR  ERROR-RETURNS. 
THE  APIS  COMMON  LOCAL  DATA. 

SERVICE  CODES  FOR  THE  NTM  SERVICE  ROUTINES. 
THE  APIS  COMMON  LOCAL  DATA  FOR  ERROR-RETURNS. 
****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 
PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


DELMBX 

ENDRUN 

SNDMSG 

SETTIM 

V^/AIT01 

RELEVB 

ERRPRO 


CALLED  DIRECTLY  BY: 


TRMNAT  -  CALL  TRMNAT2 
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USED  IN  MAIN  PROGRAM(S): 

RCLE  -  REMOTE  COMPILE  AND  LINK  EXPERT  DRIVER 
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NTM/SERV  Module  Documentation 


NAME : 

PURPOSE: 

LANGUAGE: 

MODULE  TYPE: 

EUNCTION  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 


TRMNAX 

CALL  TRMNAX2 

C 

FUNCTION 
INT  0 
TRMNAX 

.  C 

NTM 

SERVICES 

NTMSERV 


DESCRIPTION: 


SYNOPSIS 

CALL  TRMNAX  USING  USER-TERMINATE-STATUS . 


INPUTS/OUTPUTS : 

INPUTS : 

USER-TERMINATE-STATUS  PIC  X. 


OUTPUTS: 

DESCRIPTION 

TRMNAX  IMPLIMENTS  A  TWO-STEP  CALL  TO  TRMNAX 2 , 
ADDING  THE  ADDRESSES  OF  GLOBAL  AREAS  TO  THE 
PARAMETER  LIST  (IBM  COBOL  DOESN'T  ALLOW  EXTERNAL 
DATA  AREAS) . 

ARGUMENTS : 


A  =  CHAR  * 


ROUTINES  CALLED; 


APACCT 

TRMNAX2  -  TERMINATE  COMM ' S  CONNECTION  TO  THE  IISS. 
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NTM/SERV  Module  Documentation 


NAME: 

PURPOSE: 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST  : 

SUBSYSTEM: 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 


TRMNAX2 

TERMINATE  COMM ' S  CONNECTION  TO  THE  IISS. 

VAX- 11  COBOL 

SUBROUTINE 

TRMNAX2 

.COB 

NTM 

SERVICES 

NTMSERV 


DESCRIPTION: 


SINCE  COMM  DELETES  ITS  INPUT  MAILBOX,  TRMNAX  HAS  ONLY  * 
TWO  FUNCTIONS.  THEY  ARE:  SEND  THE  "AP  DYING"  MESSAGE  * 
TO  THE  COMM  APC  AND  THEN  CALL  "ENDRUN"  TO  TERMINATE  THE  * 
AP.  * 


ARGUMENTS: 


USER-TERMINATE-STATUS  =  DSPLY  rx] 
MPU-INSTANCE  =  DSPLY  [XX] 


INCLUDE  FILES: 


ADMSGH 

RETSTR 

APILCL 

SRVCDS 

COMAPC 

ERRPRO 


THE  APIS  COMMON  LOCAL  DATA  FOR  ERROR-RETURNS. 
THE  APIS  COMMON  LOCAL  DATA  FOR  ERROR-RETURNS. 
THE  APIS  COMMON  LOCAL  DATA. 

SERVICE  CODES  FOR  THE  NTM  SERVICE  ROUTINES. 
PROCESS  ERROR  INCLUDE  FILE 
PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


GETNAM 

ENDRUN 

SNDMSG 

SETTIM 

WAITOl 

RELEVB 

ERRPRO 


CALLED  DIRECTLY  BY: 


TRMNAX  -  CALL  TRMNAX2 
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USED  IN  MAIN  PROGRAM(S): 
TRMNAX  -  CALL  TRMNAX2 
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NTM/SERV  Module  Documentation 


NAME: 

PURPOSE: 

LANGUAGE : 

MODULE  TYPE: 

FUNCTION  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 


TSTMOD 

CALL  COBOL  ROUTINE  TSTMOD2 
C 

FUNCTION 
INT  0 
TSTMOD 

.C 

NTM 

SERVICES 

NTMSERV 


DESCRIPTION: 


SYNOPSIS 

CALL  TSTMOD  USING  TEST-STATUS, 

RETURN-CODE. 


INPUTS/OUTPUTS: 

INPUTS: 

TEST-STATUS  PIC  X. 

OUTPUTS : 

RETURN-CODE  PIC  X(5). 

DESCRIPTION 

TSTMOD  IMPLIMENTS  A  TWO-STEP  CALL  TO  TSTMOD2 , 
ADDING  THE  ADDRESSES  OF  GLOBAL  AREAS  TO  THE 
PARAMETER  LIST  (IBM  COBOL  DOESN'T  ALLOW  EXTERNAL 
DATA  AREAS) . 


ARGUMENTS : 


A  =  CHAR  * 

B  =  CHAR  * 


INCLUDE  FILES: 


APIEVB  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 


ROUTINES  CALLED: 


APACCT 

TSTMOD2  -  SET/RESET  THE  TEST-MODE-FLAG . 
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NTM/SERV  Module  Documentation 


NAME: 

PURPOSE: 

LANGUAGE: 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 


TSTMOD2 

SET/RESET  THE  TEST-MODE-FLAG. 

VAX- 11  COBOL 

SUBROUTINE 

TSTMOD2 

.COB 

NTM 

SERVICES 

NTMSERV 


DESCRIPTION: 


TSTMOD2  IS  TO  BE  CALLED  BY  * 
THE  UI  TO  SET/RESET  THE  TEST-MODE-FLAG  .  WHEN  SET  * 
THE  UI  VnJILL  RECEIVE  ASYNCHONOUS  ERROR  MESSAGES  FOR  * 
THE  USER  IT  IS  SERVICING.  WHEN  THE  TEST-MODE-FLAG  * 
IS  OFF,  THE  ASYNCH  ERROR  MESSAGES  WILL  BE  DISCARDED  * 


ARGUMENTS : 

TEST-STATUS  =  DSPLY  [X] 

INCLUDE  FILES: 

SRVCD2  -  THAT  CALL  NSEND  AND  RCV 

TSTMDE  -  SPACES  OR  0. 

CALLED  DIRECTLY  BY: 

TSTMOD  -  CALL  COBOL  ROUTINE  TSTMOD2 

USED  IN  MAIN  PROGRAM (S) : 

TSTMOD  -  CALL  COBOL  ROUTINE  TSTMOD2 
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NTM/SERV  Module  Documentation 


NAME: 

PURPOSE: 

LANGUAGE: 

MODULE  TYPE: 

FUNCTION  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 


WHTHST 

CALL  WHTHST2 

C 

FUNCTION 
INT  0 
WHTHST 

.C 

NTM 

SERVICES 

NTMSERV 


DESCRIPTION: 


SYNOPSIS 

CALL  WHTHST  USING  REQ-AP-NAME, 

AP-HOST-NAME, 

RETURN-STATUS. 


INPUTS/OUTPUTS: 

INPUTS: 

REQ-AP-NAME  PIC  X(10). 


OUTPUTS: 

AP-HOST-NAME  PIC  X(3). 

RETURN-STATUS  PIC  X(5). 

DESCRIPTION 

WHTHST  IMPLIMENTS  A  TWO-STEP  CALL  TO  WHTHST2 , 
ADDING  THE  ADDRESSES  OF  GLOBAL  AREAS  TO  THE 
PARAMETER  LIST  (IBM  COBOL  DOESN'T  ALLOW  EXTERNAL 
DATA  AREAS) . 


ARGUMENTS : 


A  =  CHAR  * 
B  =  CHAR  * 
C  =  CHAR  * 


INCLUDE  FILES: 


APINME  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 
BUFAPI  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 
APIEVB  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 


ROUTINES  CALLED: 


APACCT 

WHTHST2  -  RETURNS  THE  NAME  OF  THE  HOST  ON  WHICH  AN  AP 

RESIDES. 
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NTM/SERV  Module  Documentation 


NAME  : 

PURPOSE : 

LANGUAGE: 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 

DESCRIPTION: 


WHTHST2 

RETURNS  THE  NAME  OF 
AP  RESIDES. 

VAX-11  COBOL 
SUBROUTINE 
WHTHST2 
.  COB 

NTM 

SERVICES 

NTMSERV 


THE  HOST  ON  WHICH  AN 


ACCEPTS  AN  AP  NAME  FROM  A  REQUESTING  AP  AND  RETURNS 
THE  NAME  OF  THE  HOST  ON  WHICH  THE  SPECIFIED  AP  RESIDES. 
IF  THE  INFO  IS  NOT  FOUND,  AN  UNSUCCESSFUL  STATUS  CODE 
IS  RETURNED  TO  THE  CALLING  AP. 


ARGUMENTS : 


REQ-AP-NAME  =  DSPLY  [X(10)] 
AP-HOST-NAME  =  DSPLY  [X(3)] 
RETURN-STATUS  =  DSPLY  [X(5)] 
API-GLOBAL-NAME-SEC  =  RECRD 
API-GLOBAL-BUFFER-SEC  =  RECRD 
HOT-MBX-EVENT-BLK  =  DSPLY  [X(2032)] 
COLD-MBX-EYENT-BLK  =  DSPLY  [X(2032)] 
SEND-EVENT-BLK  =  DSPLY  [X(2032)] 
ACK-MBX-EVENT-BLK  =  DSPLY  [X(2032)] 
TIMER-EVENT-BLK  =  DSPLY  [X(80)] 
TEST-MODE-FLAG  =  DSPLY  [X] 


INCLUDE  FILES: 


RETSTR 
SRVRET 
SRVCD2 
APINME 
BUFAPI 
APIEVB 
TSTMDE 
ERR PRO 


THE  APIS  COMMON  LOCAL  DATA  FOR  ERROR- RETURFiS 
AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 
THAT  CALL  NSEND  AND  RCV 

****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

SPACES  OR  0. 

PROCESS  ERROR  INCLUDE  FILE 


R'jUriNES  CALLED: 


-  SEND  MESSAGE  TO  AN  AP  IN  THE  IISS. 

-  RECEIVE  MESSAGES  FROM  OTHER  AP ' S  IN  THE  IISS 


NSEND2 
RCV2 
ERR PRO 
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CALLED  DIRECTLY  BY: 


^^JHTHST  -  CALL  WHTHST2 

USED  IN  MAIN  PROGRAM(S) : 
WHTHST  -  CALL  WHTHST2 
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3.10.9  Include  File  Descriptions 

The  following  list  contains  a  purpose  and  description  of 
each  include  file  listed  in  3.10.4  as  specified  in  the  source 
code.  The  language  it  is  written  in  is  also  given. 
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NTM/SERV  Include  File  Description 


FILE  NAME:  ADMSGH 

PURPOSE:  THE  APIS  COMMON  LOCAL  DATA  FOR  ERROR-RETURNS. 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


MODIFIED  8/20/84  INITALIZE  ALL  LOCAL  VARAIBLES  TO  SPACES 

OR  0 

MODIFIED  5/24/85  CLEAN-UP. 
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NTM/SERV  Include  File  Description 


FILE  NAME:  ALMSGH 
PURPOSE:  SPACES  OR  0. 

LANGUAGE:  VAX-11  COBOL 

DESCRIPTION : 
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NTM/SERV  Include  File  Description 


FILE  NAME:  APCNMl 

PURPOSE:  APIS  GLOBAL  NAME  DATA. 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


MODIFIED  8/24/84  MSG-RCV-BUFFER  TO  OCCUR  20  TIMES. 

MODIFIED  10/25/83  TO  MOVE  AP ' S  NUMBER  OF  MAILBOXES  VALUE  TO 

TO  THE  SYSTEM  STATE  BLOCK. 

RESTORED  11/22/83 

MODIFIED  12/21/83  FOR  ACK  MAILBOX  VALUES. 

MODIFIED  1/30/84  FOR  EXPANDED  AP  NAME. 

MODIFIED  2/01/84  PARTITIONED  FROM  OLD  APISEC.INC  TO  REDUCE 

STORAGE  IN  SERVICES. 

MODIFIED  7/05/84  REMOVED  EXTERNAL  FLAG.  APM 

MODIFIED  5/24/85  CLEAN-UP.  ...  6/3/85  CLEANUP  CLEANED  UP. 
MODIFIED  6/14/85  PRONME  CONTAINS  ONLY  APNAME  AND  INSTANCE 
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NTM/SERV  Include  File  Description 


FILE  NAME:  APCNM2 

PURPOSE:  SERVICE  CODES  FOR  THE  NTM  SERVICE  ROUTINES. 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


MODIFIED  10/06/83  TO  INCLUDE  INITEX-RES-NOT-AVAI L . 

MODIFIED  11/02/83  TO  INCLUDE  WHTHST-  CODES. 

MODIFIED  1/09/84  TO  CHANGE  ERROR  CODES  TO  PIC  X(9)  A::!.  Tl 

ELIMINATE  ALPHA  CHARACTERS. 

MODIFIED  1/26/84  TO  ADD  SERVICE-SUCCESS  (GENERIC)  AND 
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NTM/SERV  Include  File  Description 


FILE  NAME:  APIEVB 

PURPOSE:  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

LANGUAGE:  C 

DESCRIPTION: 
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NTM/SERV  Include  File  Description 


FILE  NAME:  APIINI 

PURPOSE:  FOR  INITIATION  PURPOSES 

LANGUAGE:  VAX- II  COBOL 

DESCRIPTION: 


28  jan  84  :  changes  for  longer  ap  name 
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PS  620342300 
30  September  1990 


NTM/SERV  Include  File  Description 


FILE  NAME:  APILCL 

PURPOSE:  THE  APIS  COMMON  LOCAL  DATA. 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


MODIFIED  8/24/83  TO  UP  THE  SIZE  OF  MAX-IN-RCV-BUFFER  FROM 

10 

TO  20. 

MODIFIED  TO  ADD  VALUES  FOR  SYSTEM  COMMAND 

CATEGORIES. 
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T  n 


PS  620342300 
September  ]900 


NTM/SERV  Include  File  Description 


FILE  NAME:  APINME 

PURPOSE:  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

LANGUAGE:  C 

DESCRIPTION: 


i  -  J  2  3 


PS  6  2  0  3  4  2  3  0  <J 
30  September  1090 


NTM/SERV  Include  File 


Description 


FILE  NAME: 

PURPOSE: 

LANGUAGE: 


BUFAPI 

****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 
C 


DESCRIPTION: 


3-124 


NTM/SERV  Include  File  Description 


PS  620342JUU 
30  September  190u 


FILE  NAME:  COMAPC 

PURPOSE:  PROCESS  ERROR  INCLUDE  FILE 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


PS  620342300 
30  September  1090 


NTM/SERV  Include  File  Description 


FILE  NAME:  ERRPRO 

PURPOSE:  PROCESS  ERROR  INCLUDE  FILE 

LANGUAGE:  VAX-11  COBOL 

DESCRIPTION: 
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PS  620342300 
30  September  1990 


fJTM/SERV  Include  File  Description 


FILE  NAME:  FILES: 

PURPOSE:  AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 

LANGUAGE:  VAX- I I  COBOL 

DESCRIPTION: 


MODIFIED  II/2/83  TO  INCLUDE  RET-CODE-5 
MODIFIED  1/9/84  TO  INCREASE  ALL  ERROR  CODES  I'O  ITC 
AND  TO  ELIMINATE  ALPHA'S 

MODIFIED  1/26/84  TO  ADD  RET-CODE  FOR  GETUSR-NOT-.IUCC 
SRV-SUCCESSFUL  ADDED  FOR  GENERIC  RETURN 

MODIFIED  2/7/84  TO  ADD  ERROR  CODES  FOR  ENTRY-NOT-FOUND 
MODIFIED  2/8/84  TO  ADD  WHTHST-NOT-SUCCESSFUL 
MODIFIED  2/20/84  TO  ADD  TSTMOD  NEW  CODES. 


PS  6  2  0  3  4  2 
30  September  1 


NTM/SERV  Include  File  Description 


FILE  NAME:  INICMD 

PURPOSE:  PROCESS  ERROR  INCLUDE  FILE 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 
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PS  620342300 
30  September  1990 


NTM/SERV  Include  File  Description 


FILE  NAME:  MSGSTR 
PURPOSE:  PURPOSE 

LANGUAGE:  VAX-11  COBOL 

DESCRIPTION: 


MODIFIED  9/23/83  TO  IDENTIFY  ERROR  CODES  AS  FETURNED  ”TA 

SNDSAP.  NOTE  -  NO  NACK  IS  ::  LN  I  -  ALuO 
CHANGED  RESOURCE-FULL  VALUE  TO  3j. 
MODIFIED  10/06/83  TO  ADD  VALUE  FOR  SYSTEM  STATE  MESSAGE. 
MODIFIED  11/22/83  RESTORED  FROM  HARD  COPY. 

MODIFIED  1/12/84  TO  HANDLE  FIVE  CHAR  ERROR  CODE. 

MODIFIED  1/30/84  FOR  EXPANDED  AP  NAME. 

MODIFIED  2/08/84  TO  RECOGNIZE  "J"  AS  A  PAIRED  MESSAGE. 
MODIFIED  8/20/84  INITALIZE  ALL  LOCAL  VARAIBLES  TO  SPACES 

OR  0 

MODIFIED  9/20/84  ADDED  IBM  NAMES  TO  NTMNAME .  BCS  API! 

MODIFIED  5/24/35  CLEAN-UP. 
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PS  62034230U 
30  September  199U 


NTM/SERV  Include  File  Description 
FILE  NAME:  OF 

PURPOSE:  AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 

LANGUAGE:  VAX- I I  COBOL 

DESCRIPTION: 


MODIFIED  II/2/83  TO  INCLUDE  RET-CODE-5  * 

MODIFIED  1/9/84  TO  INCREASE  ALL  ERROR  CODES  TO  PIC  X(5)  * 

AND  TO  ELIMINATE  ALPHA'S  * 

MODIFIED  1/26/84  TO  ADD  RET-CODE  FOR  GETUSR-NOT-SUCC  * 

SRV-SUCCESSFUL  ADDED  FOR  GENERIC  RETURN  * 

MODIFIED  2/7/84  TO  ADD  ERROR  CODES  FOR  ENTRY-NOT-FOUND  * 

MODIFIED  2/8/84  TO  ADD  WHTHST-NOT-SUCCESSFUL  * 

MODIFIED  2/20/84  TO  ADD  TSTMOD  NEW  CODES.  * 
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PS  620342:300 
30  September  1900 


HTM/SERV  Include  File  Description 


FILE  NAME: 

PURPOSE: 

LANGUAGE: 


RETSTR 

THE  APIS  COMMON  LOCAL  DATA  FOR  ERROR-RETURNS. 
VAX-11  COBOL 


DESCRIPTION: 


MODIFIED 

MODIFIED 


8/20/84 

5/24/85 


INITALIZE  ALL  LOCAL  VARAIBLEG  TO  SPACES 
OR  0 

CLEAN-UP. 
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PS  620342300 
30  September  1990 


NTM/SERV  Include  File  Description 


FILE  NAME:  SRVCD2 

PURPOSE:  THAT  CALL  NSEND  AND  RCV 

LANGUAGE:  VAX- II  COBOL 

DESCRIPTION: 
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PS  62  0  5-;.' ■; 00 
30  September  1990 


NTM/SERV  Include  File  Description 


FILE  NAME:  SRVCDS 

PURPOSE:  SERVICE  CODES  FOR  THE  NTM  SERVICE  ROUTINES. 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


MODIFIED 

MODIFIED 

MODIFIED 

MODIFIED 

MODIFIED 

MODIFIED 


10/06/83 

11/02/83 

1/09/84 

1/26/84 

2/07/84 

5/24/85 


TO  INCLUDE  INITEX-RES-NOT-AVAT L. 

TO  INCLUDE  WHTHST-  CODES. 

TO  CHANGE  ERROR  CODES  TO  PIC  X(5)  AND  iO 
ELIMINATE  ALPHA  CHARACTERS. 

TO  ADD  SERVICE-SUCCESS  (GENERIC)  AND 
GETUSR-NOT-SUCCESSFUL. 

TO  ADD  ERROR  CODES  FOR  ENTRY-NOT-FOUND . 
CLEAN-UP. 
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PS  620342300 
30  September  1950 


NTM/SERV  Include  File  Description 


FILE  NAME:  SRVRET 

PURPOSE:  AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 

LANGUAGE:  VAX- II  COBOL 

DESCRIPTION: 


MODIFIED  11/2/83  TO  INCLUDE  RET-CODE-5  * 

MODIFIED  1/9/84  TO  INCREASE  ALL  ERROR  CODES  TO  PIC  X(5)  * 

AND  TO  ELIMINATE  ALPHA'S  * 

MODIFIED  1/26/84  TO  ADD  RET-CODE  FOR  GETUSR-NOT-SUCC  * 

SRV-SUCCESSFUL  ADDED  FOR  GENERIC  RETURN  * 

MODIFIED  2/7/84  TO  ADD  ERROR  CODES  FOR  ENTRY-NOT-FOUND  * 

MODIFIED  2/8/84  TO  ADD  WHTHST-NOT-SUCCESSFUL  * 

MODIFIED  2/20/84  TO  ADD  TSTMOD  NEW  CODES.  * 
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tJTM/SERV  Include  File  Description 


FS  620  il.FJ'j 
JO  Septembor' 


FILE  tIAME: 
PURPOSE: 
LARGUAGE : 


TSTMDE 
SPACES  OR  0. 
VAX- 11  COBOL 


DESCRIPTION: 


3.10.10  Hierarchy  Chart 

The  following  hierarchy  charts  show  the  relationships 
between  all  of  the  modules  mentioned  in  the  above  doc'umentat  i  .;n . 
A  module  may  call  a  subroutine  several  times  within  its  code, 
but  the  call  v/ill  only  be  shown  once  as  a  single  relationship;  or. 
this  hierarchy  chart.  All  modules  shown  at  the  top  of  the  firo-t 
page  are  considered  Main  Programs  as  described  in  section  3.  i  o  : 
above . 

There  is  an  internal  paging  schem.e  as  marked  by  the  num.l  ’.•iw. 
in  the  upper  right  corner  of  each  page.  An  index  after  the  list 
page  of  the  chart  shov/s  v;here  a  routine  and  its  calls  are  f  i  ro.t 
defined.  If  a  routine  has  no  page  reference,  it  either  makes  no 
calls  or  is  an  external  routine.  A  continuation  box  on  the 
of  a  tree  limb  shows  v;here  that  the  tree  continues  on  the  p.:tf.!i' 
number  mentioned.  A  number  in  a  box  with  a  routine  name  points 
to  the  page  where  the  routine  is  further  defined  within  the 
hierarchy  tree.  If  there  is  no  number  in  a  box,  the  routine 
either  makes  no  calls  or  is  an  external  routine. 


i-i  ;6 


PS  620342300 
30  September  1900 


+ - +  + - + 

|ASCTIM|  I CHGROL2 I 
+  --+ +  + - 2  + 

+ - + - 4. 

lSYS$GETTIM|  |SYS$ASCTIM| 

+ - +  + - + 


+ - + 

I CHKMSG2  j 
+ - 3  + 


+  —  +  --  + 
I NSENDj 
+ - + 


H - 1“  H - 

|FILGEN|  I (CONT) 

H - 1- - h  H - 4 


- + - + 

I  I 

I  I 

+  -  +  -+  +--  + + 

1 RCV I  I ERRPRO I 
+ +  + - + 


1 
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PS  6203-;2J00 
30  September  1990 


2 

+ - + 

1 CHGROL2 1 
+ - + - + 

i 

+ - + - + 

1  1 

+  — + - +  +--  + - + 

|NSEND2l  lERRPROl 
-( 1 1-  -| - ^ 


I  I  |  — |  — - 

-r--  + - +  +--  + - +  +--  + - +  +--+ - +  +---r - 

;SNDMSG|  ISETTIMj  |WAIT0l|  | RCVMSG |  | WAIT02 | 

+ - +  + - +  + - +  + - +  + - + 


i  (CONT)  , 
-I - D  + 
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PS  620342300 
30  September  1090 


1 CHKMSG2 I 

+ - + - + 

i 

+ - + - + 

I  I  1 

+  --  + - +  +--  + - +  + — + - + 

I RCVMSG I  1 GETMSG |  j  ERRPRO | 

+ - +  + - +  + - + 
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PS  620342300 
30  September  1990 


+ - +  + - +  + - +  + - +  + - + 

I (CONT) 1  1GDACK21  lGDSEND2|  | GETTIM [  i(CONT)l 
+ - +--  + +  + - 6+  +--  + +  + - 7  + 

1 

+ - + - + 

H - 1- - 1-  H - 1 - +  H - - H 

|NSEND2|  lERRPROj  |SYS$GETTIM| 

+ - 2+  + - +  + - + 
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PS  620342J00 
30  September  1990 


- 

1 NSEND2 I 
+  --+ - + 

I 

+ - + - + - + - + 

-j - j - 1_  -) - [ - (-  - -J - 1 - ^  - ( - (_ 

I (CONT) I  |GETMSG|  | CNLTIM |  | RELEVB |  | ERRPRO | 

+ - 2+  + - +  + - +  + - +  + - + 
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PS  620342300 
30  September  1990 


+  --H - + 

1 SNDMSG 1 
+ - + 


6 

+ - + 

I GDSEND2 I 
+ - + - + 


+  --  + - + 

I SETTIM] 
+ - + 


I 

I 

+  --  + - + 

I WAITOl 1 
+ - + 


+ — + — + 
1 RCVMSG I 
+ - + 


+  --  + + 

I WA1T02  ! 
+ - L 


(CONT)  ^ 
- 8  + 
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PS  620342300 
30  September  1990 


H - H  “I - h  + - 1-  + - h  -I - h 

I (CONT) I  |GETUSR2|  | INICOM2 |  ( INITAL2 |  |(CONT)| 

+ - 4+  + - 9+  + - 10+  + - 11+  + - 12  + 
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PS  620342300 
30  September  1990 


I GDSEND2 1 
+ - + - + 

I 

+ - + - + - + - + 

1111  1 

+  --  + - +  +--  + - +  +--  + - +  +--+ - +  +--+ - + 

I (CONT) I  |GETMSG|  |CNLTIM|  | RELEVB |  | ERRPRO | 

H - 6+  H - ^ - - i"  - ^ 
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PS  620342300 
30  September  1990 


+ - + 

1 GETUSR2 I 
+ - + - + 


+ - 

- +  _ 

1 

( 

+ — + - + 

1 

+  -4- - + 

1 

+ - + - + 

1 NSEND2 1 

1 RCV2 1 

] ERRPRO 1 

+ - 2  + 

+-+--+ 

1 

+ - + 

+ - 

1 

1 

1 

1 

- + - + 

r  1 

1 

+  --+ - + 

1 

+  - + 

! 

+ — + - + 

+ 

1 

1 

1 

— + 

1 

1 

+ 

+ 

1 

1 

1 

— + 

1 

+ 

1 RCVMSG 1 

1 WAIT02 1 

j WAITOl 1 

1 GETMSG 1  1 ERRPRO | 

+ - + 

+ - + 

+ - + 

+ - +  + - + 
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PS  620142300 
30  September  1990 


+  --I - + 

I GETNAM I 


10 


H - (" 

I INICOM2 I 
+ - + - + 


+  —  + - + 

I CRTMBXl 
+ - + 


+  --  + - + 

1 SNDMSGl 
+ - + 


H - 1 - h 

|SETTIM| 
+ - + 


+  --+ + 

1 WAITOl ] 

+ - -i- 


+ 


+  --+ - + 

I  (CONT)  i 
+ - 13  + 


PS  62  03  42  JO'J 
30  Septenber  199U 


+ - + 

1  INITAL2  I 


+ - + - + 


1 1 


+  — + + 

I LOCKEF I 

4- - + 


+ - 1 - + 

I GETNAM| 


+  —  + - + 

I CRTMBX I 
+ - + 


|-  — 

+  —  + - + 

I RCVMSG I 
+ - + 


+  --  + - + 

I SETTIM I 
+ - + 


H - 1 - + 

I  (CONT)  I 
+ - 14  + 


3-146 


PS  620342300 
30  September  1990 


4*  —  + 

I  (CONT)  I 
+ - 7  + 


-j — -( — —  —  4-  ■+'“* —  —  4- 

1INITEX2|  |INITIL2|  | ISEND2 ] 
+ - 15+  + - 16+  + - 17  + 


+  —  — h 


(CONT)  1 
- 18  + 


12 
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PS  6  2  0  3  4  2  J  0  U 
30  September  109u 


1 INICOM2 I 
+ - + - + 


-i — - 

1 

1 

1 

_ 1 - f- 

1 

+ — + - + 

1 

+ — + - + 

i 

-f - + - + 

1 

+  --  + - + 

(CONT) 

1 RCVMSG 1 

1 WAIT02 1 

1 GETMSG 1 

j  ERRPRO 1 

- 10  + 

+ - + 

+ - + 

+ - + 

+ - + 
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PS  620342300 
30  September  1990 


+ 


+  —  + - i- 

i  (CONT)  I 
+ - 11  + 


14 

+ - + 

I INITAL2 I 


+  --1 - + 

I WAIT02 I 
+ - + 


+  --  + - + 

( GETMSG I 
+ - + 


’'"I'"'' 
+  —  + + 

I SNDMSG I 
+ - + 


I 

i 

+  --  + ~t 

I WAITOl I 
+ - + 


+  --I - + 

i (CONT) I 
+ 19  + 


PS  62  0342  30(1 
30  September  1990 


+ - + 

1 INITEX2 I 


+ - + - + 


1  9 


+ - + - + - + - + - + - + 

H - 1- - 1-  ^ - 1 - H  H - 1 - 1-  H - h - h  H - 1 - (-  -j - 1- - (- 

|GETNAM|  |CRTMBX|  | SNDMSG |  [SETTIM]  |WAIT0l|  | (CONT) | 
+ - +  + - +  + - +  + - +  + - + - 20  + 
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+  --  + - + 

! GETNAM 1 
+ - + 


PS  6203 
30  September 


+ - + 


I INITIL2 I 
+ - + - + 


—  —  4 - h 

I CRTMBX I 
+ - + 


+  --+ - + 

I RCVMSG ! 
+ - + 


H - h  — h 

I SETTIMl 
+ - + 


+  —  + - + 

I WAIT02 I 
+ - + 


+ 


+ - + 

I  (CONT)  I 
+ - 21  + 


2300 

1990 

16 


ji  -  J  ‘j  1 


+ — t- — + 

j  SNDMSGl 
+ - 1- 


PS  6  2  0  3  ■;  2 
30  September  1 


1 


+ - + 


I ISEND2 I 
+  --+ - + 


+  --  + + 

I SETTIMl 
+ - + 


+  --I - + 

jWAITOlj 
+ - + 


|-  — 

+  —  + - + 

I RCVMSG I 

H - h 


+  --i - + 

I WAIT02 I 
+ - + 


+ 


+  --+ - + 

I  (CONT)  1 
+ - 22  + 
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PS  620342300 
30  September  1990 


18 

^ - H - 1-  H - H  H - (-  H - 1-  “I - 

! (CONT) I  |LOGOFF2|  | LOGON2 j  | MBXLOG |  | QSEND2 |  |(CONT)| 

4 - 12+  + - + - +  + - 23+  +  —  + - 1-  + - 24+  + - 25  + 

_j - 1 - — -I- 

-) - - f.  -I- - f-  — - - — - 1 - + 

|NSEND2|  lERRPROj  |GETNAM| 

+ - 2+  + - +  + - + 


PS  6  2  0  3  4  2  0 
3  0  September  10 


+ - + 

I INITAL2 1 
+ - + - + 


1  5 


+ - + - -(- - + - + 

I  I  !  I 

+--+ — +  +--+ — +  + — + — +  +--+ — + 

1 (CONT) I  jDELMBXl  | RELEVB |  | ERRPRO | 

+ - 14+  + - +  + - +  + - + 
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i  (CONT)  I 
+ - 15  + 


PS  6203 
30  September 


+ - + 

I INITEX2 I 
+ - + - + 


+  --  + - + 

1 RCVMSG I 
+ - + 


- -1- - + 

i 

+  --  + - + 

1 WAIT02 1 
+ - + 


’"I 

+  --+ - + 

I GETMSG I 
+ - + 


"T"' 

+--+ — -t- 

I  DEL1!BX  I 
+ - + 


+  --i - -r 

1 ERRPRO I 

-j - f- 


5  2  300 
199  0 

20 


3  -  1  'j  b 


PS  G2'J 
3  0  Sopter’.fcc 


+ - + 

I INITIL2 I 


+ - + - + 


H - 1 - ^ - 1 - i - 1 - 1- 

I  I  I  I  I  i 

- h - +  + - + - +-  + - h - \-  + - + - 1-  H - H - 1-  - - ■( - 

(CONT)  I  |GETMSG|  |  SNDMSG  |  |WAIT0lj  |  DELMBX  j  ■(COfri  ) 


FS  620J-.230U 
30  September  1990 


-I - j - -I- 

I  (CONT)  I 
+ - 17  + 


+ - + 

I ISEND2 I 
+  —  + + 

I 

—  —  —  4-  —  —  —  —  —  —  —  —  — —  —  —  —  —  4 —  —  —  — 

I  I  I 

+__+ — +  +--+ — +  +--+ — + 

jGETMSGj  |CNLTIM|  | RELEVB [ 

+ - H  + - +  + - + 


I  ERRPRO  j 


22 


3  -  1 L,  ■/ 


PS  62  034^  iu'’ 
3  0  September  I'-  '■ 


+ - + 


I LOGON2 1 
+  --+ - + 


2  i 


+ 


+ 


+ 


+  — + +  +-+  —  + 

lNSEND2|  |RCV2| 
+ - 2+  + - 9  + 


+ — + - + 


1 ERRPRO I 
+ - + 


3-158 


» 


% 


+ - + 

I  (CONT)  I 
+ - 18  + 


PS  6  2  0  3-42  i  0  ij 
3  0  September  10  3" 


2-' 


+ - +  + - +  -I- - + 

|RCLE|  |SIGABT2l  |SIGERR| 
+  --28+  + - + - +  + - 29  + 


+  --  + - + 

I NSEND2 1 
+ - 2  + 


+  — + - + 

1 ERRPRO I 
+ - + 


+ - -(- 

I  SNDRCLE I 
+ - + - -1- 


+  ---I + 

1  ISEND I 
+ - + 


1 (CONT) 
+ 3  0 


3-160 


- + 

!  (CONT)  I 
+ - 21  + 


PS  6  2  0  3  4  2  3  U  0 
30  September  199u 


26 


i INITIL2 I 
+ - + - + 

I 

- + - + 

I  ! 

+ — + — -t-  +--+ — + 

iRELEVBj  lERRPROl 
+ - +  + - + 


5~1G1 


PS  620342 
30  September  1 


+ - + 


1 QSEND2 I 
+  --+ - + 


+ - H - + - + - + 

I  1  I  I  I 

+  --+ - +  +--  + - +  +--  + - +  +--  + - +  +--+ - + 

I (CONT) 1  |GETMSG|  [ CNLTIM |  | RELEVB |  | ERRPRO 1 

+ - 24+  -f - +  + - +  + - +  + - + 
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PS  62034230U 
30  September  1990 


28 

I RCLE I 
+-+--+ 

I 

■i - \ - \ - — I - \ - i - 

- , - i-  4 - ( - 1-  - i - ^  - ) - ^  -j - - -r - 1 - ^ 

INITALl  IRCVj  [RCLFILEj  | PRECOM |  | POSTCOM j  j(CONT)j 

- r  H - S-  i - i-  H - 1 - h  ^ - 1 - 1-  -I - 31-t- 

!  i 

I  I 

+ + - +  + - -r -r 

[RCLFILEl  iRCLFII.El 

-j - j-  -j - i- 
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PS  6  2  0  3  2  7  '3 
30  Septenber  I-''' 


+ - + 

1 SIGERRj 
+  --+ + 

_ ^ 

1'”'^  I 

+  --  + - +  + - + - + 

lAPACCTj  1SIGERR21 

+ - +  + - + - + 

I 

+ - + - + 

I  I 

+ — + - +  - + 

1 NSEND2 I  1 ERRPRO | 

+  — — 2+  H —  —  — 
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PS  620342300 
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+ - + 

!  (CONT)  1 
+ - 25  + 


3  0 

+ - +  + - +  + - + 

|TRMNAX|  |TSTMOD|  | WHTHST [ 

H - 32+  H - 1 - r  H - 33  + 

^____| _ ^ 

+ 

i - 1 - H  H - 1 - f- 

jAPACCTj  |TSTMOD2l 

+ - +  + - + 
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PS  G20J4?i0'i 
3  0  September  191"' 


+ - + 

I RCLE I 

+  -H + 


-f-  —  —  4-  —  —  —  -*-■ 

j  (CONT) I  : f 
+ - 28+  +- 


+ - + - +  +--  + - f 


SYS$GETJP1 


SYS$CREPRC I 


SETTIM 


(CONT) 


-+  H - 34  + 
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PS  G  2  0  J  ■;  2  3  0  u 
30  September  lOOu 


3  2 

I TRMNAX I 
+  --+ - + 

I 

1 - i - 

APACCTI  |TRMNAX21 

- +  -t- - + - + 

I 

-I - 1 - 1 - 1 - j - j - - 

i  III:  i 

- 1 - 4 - 1 - 4 - , - -j - 1 - 1-  - - ^  .  - - - 

GETiJAMj  |ENDRUN|  |SNDMSG|  jSETTIMj  |WAITC‘l!  i(COrJT) 
- 1-  4 - h  -1 - 1-  H - 1-  -f - -  - 35*^ 


3-167 


r'S  G  2  U  j  -'i  2  j  . 
30  Septer.ber  I'-G 

+ - + 

I WHTHST I 
+  --  + - + 

+ - 1- - +  + - H - + 

1 APACCT I  I WHTHST2 | 

+ - +  + - + - + 

I 

+ - + - + 

I  I  I 

+  --  + +  +-+  —  +  +--  + - + 

|NSEND2l  |RCV2|  [ ERRPRO | 

+ - 2+  + - 9+  + - + 


* 


# 


3-168 


+  --  + - + 

I (CONT) I 
+ 31  + 


PS  620342300 
30  September  1990 


+ - + 


I RCLE I 
+  -  +  —  + 


34 


- + - 

1 

+  --  + - + 

I WAITOl I 

+ - H 


-f-  —  —  4*  + 

j  NSENDj 
+ - + 


+  --  + - + 

I TRMNAT I 
+ - 36  + 


H - [ — y- 

I ERRPRO  j 
+ - + 
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+ 


(CONT)  1 
- 3  2  + 


+ - + 

1 TRMNAX2 I 

"'I''" 
+  --+ - + 

! RELEVB] 

4 - 4- 


I 

I ERRPRO 

4 - 


PS  62  0'J--,  2  3  00 
3  0  September  lOOiO 


i TRMNAT I 

r - -I - + 


APACCT 


I TRMNAT2  j 

+ - + - h 


-  +  - 


DEU-!BX 


I ENDRUN I 
+ - + 


|SNDMSG|  iSETTIMj  jWAITOl 


3 


(CONI ; 


PS  6  2  (J  i  •  1  ?  '  I 

30  Septonbor  lO'- 


+ - + 


|TRMNAT2 | 
+ - + - + 


+ 

4  --  + - + 

I  (CONT)  I 
- 36  + 


"'i"” 

H - + - + 

1 RELEVB| 
+ - + 


+ 

H - H - 

I ERRPRO I 
+ - + 


\ 


\ 

§ 
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PS  62  0  nr 
0  S ept er.be  r  1  ^  o ; i 


APACCT 
ASC'riM . 

. 1 

CHGROL2 .  .  .  . 

. 2 

CHKRSG2  .... 

. 3 

CXLTIM 

CRTMB.X 

DELMBX 

e!;erui; 

ERR PRO 

PI  lc-r:; . 

. 1 

GDACK2 . 

GESEND2 .  .  .  . 

. 6 

GET MSG 
GETMAM 
GETTIM . 

•  •  •  •  • 

GETESR2 . . . , 

. 9 

i:;iccM2  .  .  .  . 

.  ...  10 

I'lITAL 
i:;ri  AL2  .  .  .  . 

.  ...  11 

i:iIlEX2  .  .  .  . 

.  .  .  .  1  o 

i:;iTiL2 . . . . 

....  1 6 

ise!;d 

rsE!;D2 . 

.  ...  17 

LOCKEF 
I.OGOFF2  .  .  .  . 

.  ...  18 

LOGO!!  2 . 

.  ...  23 

MBXLOG . 

.  ...  18 

MSEtlD 

::SE!JD2 . 

. 2 

POSTCOM .... 

.  ...  28 

PRECOM . 

.  ...  28 

CSEtID2 . 

.  ...  24 

ROLE . 

.  ...  28 

RCLFILE 

HC'.’ 

SYS$GETTIM 


TRMNAT . 0  6 

TRMNAT2 . 3  6 

TRMNAX . 3  2 

TRMNAX2 . 3  2 

TSTMOD . 3  0 

TSTMOD2 

WAITOl 

WAIT02 

KHTHST . 3  3 

KHTHST2 . 3  3 


PS  6  2  0  3  ;  2 

3  0  S>eptcr0.or  1 


3.11  Program  Listings  Comments 

This  information  is  contained  in  the  Module  Descriptions  in 
section  3.10. 
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SECTION  4 


PS  620342300 
30  September  1990 


QUALITY  ASSURANCE  PROVISIONS 


4 . 1  Introduction  and  Definitions 

"Testing"  is  a  systematic  process  that  may  be  preplanned 
and  explicitly  stated.  Test  techniques  and  procedures  may  be 
defined  in  advance  and  a  sequence  of  test  steps  may  be 
specified.  "Debugging"  is  the  process  of  isolation  and 
correction  of  the  cause  of  an  error. 

"Antibugging"  is  defined  as  the  philosophy  of  writing 
programs  in  such  a  way  as  to  make  bugs  less  likely  to  occur  and 
when  they  do  occur,  to  make  them  more  noticeable  to  the 
programmer  and  the  user.  In  other  words,  as  much  error 
checking  as  is  practical  and  possible  in  each  routine  should  be 
performed. 

4 . 2  Computer  Programming  Test  and  Evaluation 

The  quality  assurance  provisions  for  test  consists  of  the 
normal  testing  techniques  that  are  accomplished  during  the 
construction  process.  They  consist  of  design  and  code 
walk-throughs,  unit  testing,  and  integration  testing.  These 
tests  are  performed  by  the  design  team.  Structured  design, 
design  walk-through  and  the  incorporation  of  "antibugging" 
facilitate  this  testing  by  exposing  and  addressing  problem 
areas  before  they  become  coded  "bugs". 
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